Kies de Zapier-verbinding die bij uw API-contract past
Het HTTP-recept in deze handleiding roept GenderAPI.io V2 aan op https://api.genderapi.io/api/v2/gender. Verstuur type en value in de JSON-body; de voorspelling staat in data, terwijl de gegevens over het verzoek en de afschrijving in meta staan. Native connectors hebben hun eigen contract, dat hieronder wordt beschreven.
Zapier biedt GenderAPI.io-acties om het geslacht te bepalen op basis van een naam of een e-mailadres. De openbare pagina vermeldt noch de versie van het endpoint noch het contract van het V2-antwoord. Controleer de output van de bestaande native acties voordat u koppelingen in volgende stappen wijzigt.
De V2-configuratie hieronder gebruikt Webhooks by Zapier met een gestructureerd POST-verzoek. Webhooks by Zapier vereist een betaald Zapier-abonnement. Het saldo van het GenderAPI-account en de in Zapier verbruikte taken worden afzonderlijk in rekening gebracht.
Bereid het account en het bronrecord voor
Dit voorbeeld verrijkt records in Mailchimp op basis van het e-mailadres. U hebt toegang nodig tot de bron- en doelapplicatie, een API-sleutel van uw GenderAPI.io-account en de platformfuncties die de HTTP-actie gebruikt. Deze handleiding bevat geen werkende inloggegevens of gekoppelde accounts.
V1 en V2 gebruiken dezelfde accountsleutel en hetzelfde saldo. Controleer de sleutel met GET /api/v2/usage voordat u een betaald verzoek configureert, en controleer of meta.access.mode in het antwoord van dit endpoint de waarde api_key heeft. Een ontbrekende of niet-herkende sleutel kan ertoe leiden dat de gedeelde IP-proefperiode wordt gebruikt; een automatisering in productie mag daar niet ongemerkt van afhangen.
Houd de workflow uitgeschakeld terwijl u deze configureert. Een testvoorspelling verbruikt gewone credits. Deze handleidingen zijn gecontroleerd aan de hand van de openbare documentatie en het V2-contract; voor deze publicatie is op geen enkel platform een geauthenticeerde workflow van begin tot eind uitgevoerd.
Het GenderAPI.io V2-verzoek configureren in Zapier
- Begin met een Mailchimp-trigger die het juiste record van de abonnee levert. Sla de ID van het publiek (Audience) en van het contact op en voeg vóór de HTTP-actie een filter toe dat lege e-mailadressen overslaat.
- Kies Webhooks by Zapier en de actie POST. Vul de URL hieronder in en Payload Type: JSON. Voeg de gegevensvelden type = email, value = gekoppeld e-mailadres van de abonnee en options__ai_mode = off toe.
- In Zapier nest de notatie met dubbele underscore options__ai_mode als options.ai_mode in de JSON-body. Het codeblok hieronder toont de body die de API ontvangt; het is geen vierde veld dat u aan de actie moet toevoegen.
- Voeg in de sectie Headers Authorization toe met de waarde Bearer YOUR_API_KEY. Gebruik application/json als Content-Type. Zet de sleutel niet in de velden van de trigger, in de querystring of in voorbeeldantwoorden.
| HTTP-instelling | Waarde | Doel |
|---|---|---|
Method | POST | Verstuurt één voorspellingsverzoek. |
URL | https://api.genderapi.io/api/v2/gender | V2-endpoint van GenderAPI.io voor losse voorspellingen. |
Authorization | Bearer YOUR_API_KEY | Vervang de placeholder via de authenticatie- of headerinstellingen van het platform. |
Content-Type | application/json | Verstuur een object met een genest options-object, geen formuliervelden. |
options.ai_mode | off | Bewuste eerste test met alleen de dataset: normale afschrijving van 1 credit, ook als het resultaat unknown is. |
Controleer de JSON-body voordat u deze verstuurt
Dit voorbeeld toont een vaste invoer; het is geen verwacht resultaat. Controleer eerst de structuur van het verzoek en vervang daarna value door het gekoppelde bronveld, met een correcte JSON-serialisatie. Stuur de koppelingsexpressies van het platform niet als letterlijke tekst naar de API.
Stel voor andere invoer type in op name, email of username en geef de bijbehorende waarde op in value. Voeg country alleen toe als u over betrouwbare context beschikt: het veld is optioneel en dient niet om het land van verblijf vast te stellen.
{
"type": "email",
"value": "alex@example.com",
"options": {
"ai_mode": "off"
}
}Controleer de HTTP-stap voordat u updates inschakelt
De headers van de webhook zijn geen apart veld voor geheimen: wie de Zap kan bewerken, ziet ze. Beperk de toegang en deel de Zap, schermafbeeldingen of exports met referenties niet. Zapier biedt ook API by Zapier met opgeslagen referenties, maar daar verschilt de configuratie van de body van het verzoek van dit gestructureerde POST-recept.
Pak de body niet in: verstuur één object, geen lijst of array. Kies de gestructureerde JSON-actie voor gekoppelde klantgegevens; Custom Request verstuurt ruwe tekst en past geen automatische escaping toe op speciale tekens in de ingevoerde waarden.
Verwerk identified-resultaten, unknown-resultaten en fouten afzonderlijk
Analyseer de body van het antwoord voordat u een update in het doelsysteem kiest. De JSON-paden hieronder verwijzen naar de body van het V2-antwoord; uw platform kan deze inpakken of afvlakken. Controleer de daadwerkelijk teruggegeven structuur met een beperkte test en sla het resultaat op samen met de ID van het bronrecord.
Een voorspelling stelt noch de identiteit van een persoon vast, noch het geslacht dat de persoon zelf opgeeft. Bewaar deze apart van de gegevens die de persoon zelf heeft verstrekt. Leg acceptatiecriteria vast op basis van gegevens die representatief zijn voor uw toepassing en beoordeel de betrouwbaarheidsscore van de dataset en die van de AI afzonderlijk.
| Controle | Verwachte waarde of type | Beslissing in de workflow |
|---|---|---|
meta.access.mode | api_key voor deze workflow met account | Stop de workflow als de waarde ip_trial is en corrigeer de sleutel. Een geslaagd antwoord van de IP-proefperiode bewijst niet dat het account is geauthenticeerd en kan al credits van de proefperiode hebben verbruikt. |
meta.usage.billing_status | confirmed of unconfirmed | Als de waarde unconfirmed is, sla dan de ID van het verzoek op en verduidelijk de afschrijving voordat u een nieuwe poging doet of verdergaat. |
data.result_status / data.gender | identified met male of female; unknown met null | Sla geaccepteerde identified-resultaten op in een apart veld voor afgeleide gegevens. Laat unknown-resultaten staan zonder een standaardcategorie toe te wijzen. |
data.confidence / data.confidence_kind | Getal van 0 tot 1 of null; type bewijs of null | Interpreteer observed_frequency en model_reported afzonderlijk; geen van beide waarden garandeert een algemene nauwkeurigheid. |
data.source / data.sample_count | dataset, ai of none / geheel getal of null | Sla de herkomst van de voorspelling op. De AI heeft geen opgeslagen steekproefomvang; een steekproefomvang van de dataset is geen maatstaf voor de nauwkeurigheid van het product. |
meta.request_id / meta.usage | Referentie van het verzoek / verbruiksobject | Sla beide op samen met het workflowrecord en het resultaat. Schrijf geen API-sleutels of overbodige persoonsgegevens in gewone logs. |
HTTP-fout / geen antwoord | Problem Details of geen volledig antwoord | Stop de update en controleer de fout en de status van de afschrijving. Een time-out bewijst niet dat de server niets heeft verwerkt. |
Werk in Mailchimp alleen het bijbehorende record bij
Bekijk het geanalyseerde antwoord van de testactie en kies de velden voor data.gender, data.result_status en de andere hierboven genoemde V2-paden. De veldkiezer van Zapier kan geneste labels afvlakken: ga uit van de waargenomen waarde en het bovenliggende pad in plaats van het oude veld probability van de native connector te veronderstellen. Werk alleen de Mailchimp-abonnee bij wiens ID is opgeslagen.
Test de vertakkingen voor een identified resultaat, een unknown resultaat en een fout voordat u updates inschakelt. Met fictieve voorbeeldantwoorden kunt u de voorwaarden van de vertakking controleren zonder een nieuwe voorspelling te versturen. De update in de doelapplicatie moet afhangen van de hierboven genoemde controles en mag geen niet-gerelateerde velden of tags overschrijven.
Nieuwe pogingen en herhaalde afschrijvingen beheersen
Controleer in Zapier de instellingen voor Autoreplay en voor handmatig herhalen (Replay) voordat u de Zap activeert. Het herhalen van een mislukte webhookactie verstuurt een nieuw verzoek; herhaal een geslaagd verzoek niet alleen om een volgende Mailchimp-stap te corrigeren. Sla de oorspronkelijke ID van de abonnee en het resultaat van het verzoek samen op.
Elk nieuw verzoek aan GenderAPI is een afzonderlijke bewerking. Verwijder dubbele, herhaalde brongebeurtenissen in uw workflow vóór het versturen, met behulp van het opgeslagen bron-ID en de verwerkingsstatus. Het ID van het bronrecord is geen sleutel die aan de serverkant tegen herhalingen beschermt.
Een geslaagd unknown resultaat is een volledig resultaat dat wordt afgeschreven. Bij een time-out of een onvolledig antwoord kunnen het resultaat en de afschrijving onbekend zijn: sla de verzoekreferentie op als die beschikbaar is en stel de afschrijving vast voordat u het verzoek opnieuw verstuurt. Respecteer de header Retry-After wanneer die bij een antwoord over een overschreden verzoeklimiet wordt meegestuurd.
Bepalen wanneer u AI gebruikt
forceToGenderize is optioneel voor namen, e-mailadressen en gebruikersnamen. Als het is ingeschakeld, laat ai_mode dan weg of gebruik fallback; off en always kunnen niet met deze optie worden gecombineerd en geven 422 terug. Een positief beginsaldo is genoeg om een verzoek te starten, ook als de uiteindelijke afschrijving het saldo negatief maakt.
De bijnaammodus kan een geslacht teruggeven samen met name: null. Ook een onbekend resultaat is mogelijk. Noch de normale AI-fallback noch de bijnaaminterpretatie garandeert een juist antwoord of een waarde anders dan null.
| Optie in het verzoek | Werking | Credits per geslaagde zoekopdracht |
|---|---|---|
| options.ai_mode: off | Gebruikt alleen de dataset. | 1, ook bij een onbekend resultaat |
| options.ai_mode: fallback | Raadpleegt eerst de dataset en gebruikt daarna de normale AI als er geen geslacht wordt teruggegeven. Dit is de standaardwaarde voor losse verzoeken. | In totaal 1, inclusief AI-fallback |
| options.ai_mode: always | Gebruikt direct AI. | 2 |
| forceToGenderize: true | Raadpleegt eerst de dataset en laat daarna AI een persoonlijke bijnaam of alias interpreteren, ook zonder echte voornaam. | 1 voor een resultaat uit de dataset; in totaal 2 als AI wordt gebruikt |
Controleer de workflow voordat u het volume verhoogt
- Controleer met een beperkte test de daadwerkelijk geserialiseerde JSON, de geanalyseerde resultaatpaden, de toegang met API-sleutel en de bevestiging van de afschrijving. Test indien mogelijk met voorbeeldantwoorden hoe unknown-resultaten en fouten worden verwerkt.
- Maak duidelijk welke stappen van de workflow worden herhaald en welke klantvelden worden gewijzigd. Sla de ID van het bronrecord, het ontvangen antwoord en de referentie van het verzoek op, zodat een latere fout in het doelsysteem geen nieuw verzoek vereist.
- Activeer eerst een kleine, gecontroleerde uitvoering en controleer de records en credits voordat u het parallellisme verhoogt. De credits van GenderAPI en de taken of bewerkingen die het automatiseringsplatform in rekening brengt, zijn afzonderlijke kosten.
- Gebruik voor batches POST /api/v2/gender/batch met maximaal 50 items bij toegang met een API-sleutel of 10 met de IP-proefperiode. De items-array kan namen, e-mailadressen en gebruikersnamen combineren, met expliciete opties en een unieke id per item. Controleer elk resultaat: een HTTP 200-antwoord kan fouten bij afzonderlijke items bevatten. Batchondersteuning in een native connector moet afzonderlijk worden gecontroleerd.
Veelgestelde vragen
Waarom gebruikt de Zapier-configuratie options__ai_mode?
De gestructureerde POST-actie van Webhooks gebruikt een dubbele underscore om geneste JSON te maken. De API ontvangt options: {ai_mode: off}, waarbij off een string is. Er wordt geen letterlijk veld options__ai_mode op het hoogste niveau ontvangen.
Staat het directe HTTP-voorbeeld het gebruik van AI toe?
De body van het eerste verzoek stelt options.ai_mode in op off. Wijzig de waarde bewust in fallback om de gewone AI-fallback te gebruiken voor in totaal 1 credit, of in always om de AI direct te gebruiken voor 2 credits. forceToGenderize raadpleegt eerst de dataset: dit kost 1 credit als het verzoek daar wordt opgelost, of in totaal 2 als de AI wordt gebruikt.
Is een unknown-resultaat gratis en kan het zonder risico automatisch worden herhaald?
Nee. Een geslaagd unknown-resultaat is volledig en wordt afgeschreven. Een nieuwe poging is een nieuwe zoekopdracht. Controleer bij een transportfout of een onbevestigde afschrijving de teruggegeven verbruiksgegevens en de referentie van het verzoek voordat u besluit het opnieuw te versturen.
Is deze workflow uitgevoerd met een gekoppeld account?
Nee. De configuratie-instructies van de platforms zijn op 26 september 2026 gecontroleerd aan de hand van hun openbare documentatie. De uitleg over het verzoek en het antwoord van GenderAPI.io V2 is op 27 september 2026 gecontroleerd. De controle van deze Nederlandse versie op 28 september 2026 is een controle van de vertaling en geen nieuwe test met een account. Test met uw eigen account de actuele velden van de gekozen actie, de authenticatie, de body van het verzoek, het antwoord en de nieuwe pogingen voordat u updates in productie activeert.
Referentiedocumentatie
De Nederlandse versie is voor het laatst gecontroleerd op . De informatie over de platforms is gebaseerd op hun openbare documentatie, gecontroleerd op 26 september 2026. Deze controle is geen nieuwe test met een gekoppeld account. Controleer de actuele configuratie en beschikbaarheid in de officiële documentatie van de platforms.