Pabbly Connect koppelen aan GenderAPI.io V2

Kies de Pabbly Connect-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.

De openbare directory van Pabbly bevat een app met de naam Gender API, maar de gecontroleerde vermelding noemt noch het domein van de leverancier, noch de versie van het endpoint, noch het volledige schema van het antwoord. De naam alleen bewijst niet dat het om GenderAPI.io gaat. Controleer de leverancier en de daadwerkelijke velden voordat u een native actie kiest.

Gebruik voor een expliciet V2-endpoint de functie voor aangepaste API-verzoeken van API by Pabbly. Dit recept beschrijft dat HTTP-verzoek; het beweert niet dat de native connector naar V2 is gemigreerd.

Bereid het account en het bronrecord voor

Dit voorbeeld verrijkt records in Shopify op basis van de naam. 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.

Authenticatie en gratis controle van het verbruik

Het GenderAPI.io V2-verzoek configureren in Pabbly Connect

Kies een Shopify-trigger die past bij de klantgebeurtenis die u nodig hebt en haal een representatief testrecord op. Sla de klant-ID op en koppel het beschikbare naamveld. Sla een lege naam over in plaats van deze te vervangen door het volledige klantrecord.
Voeg API by Pabbly toe en kies Custom Request. Kies POST en de V2-URL hieronder. Configureer de authenticatie met Bearer token en de GenderAPI-sleutel, of met een Authorization-header waarvan de volledige waarde Bearer YOUR_API_KEY is; configureer niet beide mechanismen tegelijk.
Stel Content-Type in op application/json. Custom Request heeft een veld Data voor de JSON-body. Maak een object met type = name, value = gekoppelde naam en een object options met ai_mode = off. De header Content-Type beschrijft de opgegeven body; die zet de velden van een formulier niet vanzelf om in een JSON-object.
Houd options genest. Als de gekozen actie alleen ruwe JSON accepteert, zorg er dan voor dat aanhalingstekens, backslashes en regeleinden in de gekoppelde waarden correct in JSON worden gecodeerd; gebruik een ondersteunde stap om de JSON te maken in plaats van ongecodeerde klanttekst in te voegen.

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": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}

Velden, typen en standaardwaarden van het verzoek

Controleer de HTTP-stap voordat u updates inschakelt

Bekijk de opgehaalde body van het antwoord en zorg ervoor dat de volgende stap de V2-body leest en niet de statusvelden van het transport. Pabbly kan de sleutels van het antwoord beschikbaar maken voor de volgende koppeling; controleer hun daadwerkelijke pad in uw workflow.

Voer tijdens de configuratie alleen de gekozen testactie uit. Een test die een verzoek verstuurt, kan GenderAPI-credits en taken van het platform verbruiken nog voordat de workflow is geactiveerd.

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 Shopify alleen het bijbehorende record bij

Sla de Shopify-klant-ID op die de trigger levert. Stuur bevestigde identified-resultaten naar het beoogde klantveld of volgens het beleid voor tags, laat unknown-resultaten unknown en wijzig de naam die de klant heeft opgegeven niet. Sla source en confidence_kind op voor elke geaccepteerde voorspelling.

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

Pabbly documenteert Auto Re-execution en handmatige opties om mislukte of overgeslagen stappen of de hele workflow opnieuw uit te voeren. Controleer wat er wordt uitgevoerd voordat u een van deze opties gebruikt. Het opnieuw uitvoeren van de hele workflow kan een al voltooid GenderAPI-verzoek herhalen; corrigeer een latere fout in Shopify indien mogelijk met het opgeslagen antwoord.

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.

Credits en afschrijvingsstatus

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

Kan ik in Pabbly een plat formulierveld options.ai_mode gebruiken?

De V2-body voor POST vereist een JSON-object options. Een punt in het label van het veld bewijst op zichzelf niet dat het platform een genest object maakt. Controleer de geserialiseerde body voordat u het verzoek verstuurt en zorg ervoor dat deze overeenkomt met het voorbeeld.

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 28 september 2026. 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.