Koppel velden met de extensie voor Airtable
De GenderAPI-extensie leest een naam of e-mailadres uit een gekozen veld en schrijft de voorspelling van het geslacht naar een apart doelveld. U kunt ook land, probability en gevonden naam koppelen, en records overslaan waarvan het doelveld voor het geslacht al een waarde bevat.
De code van de extensie, gecontroleerd op 27 september 2026, gebruikt de V1-endpoints voor namen en e-mailadressen en de bijbehorende responsvelden op het hoogste niveau. Deze gids beschrijft die native workflow. De geïnstalleerde extensie kan onafhankelijk van de gids veranderen: controleer de beschikbare instellingen voordat u de onderstaande koppelingen toepast.
Verbind de base en bereid de velden voor
- Open de juiste base, voeg GenderAPI.io toe via Extensions en start de extensie. Voltooi de verbindingsstappen die de extensie toont.
- Kies de sleutel waarvan de credits worden gebruikt. Controleer het resterende saldo en of de sleutel bij het juiste GenderAPI-account hoort.
- Kies de tabel en het bronveld met de namen of e-mailadressen. Laat de oorspronkelijke invoer in dat veld staan en maak aparte velden voor de resultaten.
- Selecteer het verplichte doelveld voor het geslacht en eventuele extra doelvelden. Gebruik een percent-veld voor een opgemaakte procentwaarde of een getalveld om de oorspronkelijke schaal van probability te behouden.
- Bepaal of u al ingevulde doelvelden voor het geslacht wilt behouden. De optie om ze over te slaan behoudt ook onopgeloste tekstwaarden van een eerdere uitvoering. Wis daarom alleen de resultaten die u bewust opnieuw wilt verwerken.
Koppel de invoer en uitvoer van de extensie
Het bronveld kan zowel namen als e-mailadressen bevatten. In de gecontroleerde implementatie volgt een waarde met @ het e-mailpad; deze routeringsregel controleert niet of de mailbox bestaat.
| Instelling van de extensie | Verplicht | Waarde en gedrag |
|---|---|---|
| Sleutel voor credits | Ja | De sleutel van het geselecteerde GenderAPI-account levert de credits voor de verwerkte verzoeken. |
| Tabel en bronveld | Ja | De broncel bevat een naam of e-mailadres. Lege broncellen worden overgeslagen. |
| Doelveld voor het geslacht | Ja | Ontvangt het native veld gender. Houd een onopgeloste waarde gescheiden van male en female. |
| Doelveld voor het land | Nee | Ontvangt de geretourneerde waarde country. Dit is een uitvoerkolom, geen landfilter voor het verzoek. |
| Doelveld voor probability | Nee | Ontvangt de waarde probability van de legacy-API. Een percent-veld ontvangt de waarde gedeeld door 100; een getalveld behoudt de oorspronkelijke schaal. |
| Doelveld Found Name | Nee | Ontvangt de naam die de native API retourneert, indien beschikbaar. Houd deze afgeleide kandidaat gescheiden van de bronwaarde. |
| Ingevulde geslachtsvelden overslaan | Nee | Behoudt records waarvan het doelveld al een waarde bevat, inclusief onopgeloste tekst. Controleer de status van de optie vóór elke uitvoering. |
Test een kleine batch voordat u de tabel verwerkt
Begin met een kleine testtabel met een naam, een e-mailadres, een lege cel en een dubbelzinnige invoer. Controleer de gekozen doelvelden en hoe Airtable de schaal van probability weergeeft voordat u de hoofdtabel verwerkt.
In de gecontroleerde code kunnen onopgeloste standaardwaarden verschijnen als de tekst null en probability 0. Ook sommige mislukte native responses kunnen deze standaardwaarden achterlaten, terwijl een verbindingsfout een record ongewijzigd kan laten. Controleer de status van de uitvoering en de betrokken rijen: de tekst null alleen bewijst niet dat de zoekopdracht is gelukt.
Controleer de bestaande waarden na de uitvoering. Bewaar onopgeloste resultaten voor controle in plaats van zelf een geslacht toe te wijzen. Een voorspelling op basis van de naam bevestigt de genderidentiteit van een persoon niet, en een geretourneerd land bewijst niet waar iemand woont.
| Wat u ziet | Wat u doet |
|---|---|
| Verwacht resultaat in de beoogde kolommen | Bewaar de oorspronkelijke invoer en de extra velden, zodat de koppeling controleerbaar blijft. |
| Tekst null of probability 0 | Laat het geval onopgelost en controleer de verwerkingsstatus voordat u over een nieuwe zoekopdracht beslist. |
| Een al ingevuld doelveld is ongewijzigd gebleven | Controleer de optie voor overslaan; het behouden van de waarde kan opzettelijk zijn. |
| Melding over sleutel of credits, of ongewijzigd resultaat na een fout | Los het account- of verbindingsprobleem op en bepaal de betrokken records voordat u opnieuw start. |
Houd verbruikte credits en nieuwe uitvoeringen in de gaten
De native extensie zoekt waarden één voor één op met de geselecteerde GenderAPI-sleutel. Een nieuwe uitvoering op dezelfde niet-overgeslagen records kan nieuwe verzoeken versturen en opnieuw credits verbruiken. Het Airtable-abonnement en de beschikbaarheid van de extensie staan los van dit accountsaldo.
De native uitvoer biedt geen data/meta uit de V2-response, geen expliciete keuze voor de AI-modus, geen usage-object per item en geen V2-batchcontract. Gebruik de V1-documentatie voor deze workflow en het afzonderlijke API-alternatief hieronder wanneer u deze instellingen nodig hebt.
De extensie verstuurt de gekoppelde waarden voor verwerking en schrijft de resultaten terug naar uw base. Controleer het gepubliceerde beleid voor gegevensverwerking en de rechten van de extensie voor de betrokken records; neem geen irrelevante velden op in de bronkoppeling.
Gebruik V2 wanneer u een gestructureerde response nodig hebt
Voor een eigen integratie accepteert GenderAPI V2 namen, e-mailadressen en gebruikersnamen en retourneert het expliciete velden voor resultaat, betrouwbaarheidsscore, bron en verbruik. Configureer die verbinding afzonderlijk: het lezen van de V2-gids wijzigt de geïnstalleerde app en de uitvoerkolommen ervan niet.
De voorbeelden in Python en Node.js behandelen losse verzoeken, batches, unknown-resultaten en operationele fouten. Begin met de gids voor authenticatie en kies de AI-modus voordat u een verzoek verstuurt waarvoor een afschrijving geldt.
Veelgestelde vragen
Gebruikt de extensie voor Airtable GenderAPI V2?
De code van de extensie, gecontroleerd op 27 september 2026, gebruikt de V1-endpoints voor namen en e-mailadressen. Een eigen V2-verbinding heeft andere verzoek- en responsvelden; deze werkt de geïnstalleerde extensie niet bij.
Kan een bronveld zowel namen als e-mailadressen bevatten?
Ja. De gecontroleerde extensie stuurt niet-lege waarden met @ naar de zoekopdracht op e-mail en andere waarden naar de zoekopdracht op naam. Dit is routering van de invoer, geen controle van de mailbox.
Waarom ziet probability er anders uit in een procentveld?
De extensie deelt de waarde probability van de legacy-API door 100 voor een percent-veld in Airtable, zodat Airtable deze als percentage kan weergeven. Een getalveld behoudt de oorspronkelijke schaal; dit is niet het V2-veld confidence.
Behoudt de optie voor overslaan onopgeloste resultaten?
Ja, wanneer het doelveld al een waarde bevat, inclusief de tekst null van een eerdere uitvoering. Controleer die records en wis alleen de waarden die u bewust opnieuw wilt verwerken.
Referentiedocumentatie
De handleiding is voor het laatst gecontroleerd op . Controleer de installatie in de documentatie van het platform en gebruik de gekoppelde API-documentatie voor een afzonderlijke V2-integratie.