Pipedream koppelen aan GenderAPI.io V2

Kies de Pipedream-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.

Het openbare GenderAPI.io-component van Pipedream, gecontroleerd op 26 september 2026, gebruikt de oude basis https://api.genderapi.io/api en verstuurt name of email, optioneel country en de API-sleutel als queryparameters. De gepubliceerde implementatie is een V1-connector en geen JSON-endpoint van V2.

U kunt de bestaande native actie met het bijbehorende contract behouden of een algemene HTTP-stap voor V2 toevoegen. Ga er niet van uit dat de automatische authenticatie van het native gekoppelde account geschikt is voor dit afzonderlijke V2-verzoek: het recept gebruikt expliciet een Bearer-header.

Bereid het account en het bronrecord voor

Dit voorbeeld verrijkt records in Twilio SendGrid 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.

Authenticatie en gratis controle van het verbruik

Het GenderAPI.io V2-verzoek configureren in Pipedream

Kies een Twilio SendGrid-gebeurtenis of een planning die past bij uw account en uw workflow. Controleer een testcontact, sla de stabiele ID ervan op en sla lege e-mailadressen over vóór de verrijkingsstap. Het beschikbare interval voor de trigger is een instelling van het platform en geen toezegging van GenderAPI.
Voeg de actie Send any HTTP Request toe, kies POST en vul de URL hieronder in. Configureer een JSON-body met type = email, value = e-mailadres van het contact en options.ai_mode = off.
Sla de sleutel op met de bedieningselementen van Pipedream voor referenties of omgevingsvariabelen. Stel Authorization in op Bearer gevolgd door het geheim en Content-Type op application/json. Blijf de native authenticatie met de sleutel in de querystring niet gebruiken en toon de sleutel in geen enkele stap.
Maak de body als JSON-object met de koppelingsopties die de actie ondersteunt. Stel geen ruwe JSON samen door de waarden van het contact aan elkaar te plakken zonder escaping van speciale tekens. Controleer de voorvertoning van het verzoek voordat u een beperkte test uitvoert.

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"
  }
}

Velden, typen en standaardwaarden van het verzoek

Controleer de HTTP-stap voordat u updates inschakelt

Bekijk het antwoord dat de HTTP-stap exporteert en zoek de geanalyseerde body. Als de gekozen actie de body als tekst teruggeeft, analyseer deze dan één keer voordat u data en meta leest. Het veld data van de transportverpakking is iets anders dan het veld data van de V2-body.

Gebruik voor een codegebaseerde workflow met expliciete controle over time-outs, omleidingen en nieuwe pogingen de geteste Node.js-handleiding hieronder. De algemene actie en de native app kunnen verschillende standaardinstellingen voor transport hebben.

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

Sla de contact-ID die de trigger teruggeeft op samen met de geanalyseerde V2-body. Werk na de hierboven beschreven controles van de resultaten alleen de beoogde aangepaste velden in SendGrid bij. Behoud de naam die het contact heeft opgegeven: een data.name die uit het e-mailadres is afgeleid, is een kandidaat op basis van afleiding en geen gecontroleerde vervanging.

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

Pipedream documenteert automatische nieuwe pogingen, afhankelijk van het abonnement, vanaf de mislukte stap. Controleer deze instellingen en het gedrag van nieuwe pogingen van de gekozen HTTP-actie. Een nieuwe poging in een mislukte verrijkingsstap kan nieuwe kosten met zich meebrengen; een latere fout in het doelsysteem moet worden gecorrigeerd met de opgeslagen output van de verrijking.

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

Gebruikt de native GenderAPI.io-actie van Pipedream V2?

Het openbare component dat op 26 september 2026 is gecontroleerd, gebruikt de oude V1-endpoints en authenticatie met de sleutel in de querystring. Gebruik voor een V2-verzoek het expliciete HTTP-recept voor V2 en controleer het gepubliceerde component opnieuw als de versie ervan verandert.

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.