Kies de Make-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.
Make biedt een GenderAPI.io-app met acties voor namen en e-mailadressen. De openbare pagina verwijst naar genderapi.io, maar vermeldt noch de exacte versie van het endpoint noch het volledige schema van het antwoord. Controleer de daadwerkelijke output van de gekozen module voordat u de koppeling in bestaande scenario's wijzigt.
Gebruik voor expliciet V2-gedrag de HTTP-app van Make met het verzoek hieronder. Deze HTTP-configuratie werkt geen bestaande GenderAPI-module bij: laat scenario's die in gebruik zijn afzonderlijk doorlopen totdat hun vervanging is gecontroleerd.
Bereid het account en het bronrecord voor
Dit voorbeeld verrijkt records in Shopify 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 Make
- Kies een Shopify-trigger voor klanten die bij uw scenario past en laad een representatief testrecord. Sla de klant-ID op voor de uiteindelijke update en sla records met een leeg e-mailadres over.
- Voeg HTTP > Make a request toe. Kies in de huidige HTTP-app de authenticatie API key en maak referenties aan met de sleutelwaarde Bearer YOUR_API_KEY, de locatie Header en de parameternaam Authorization. Gebruik dit referentiebeheer in plaats van de sleutel in de URL te zetten.
- Stel de methode in op POST en gebruik de URL hieronder. Kies application/json voor de body van het verzoek en een gegevensstructuur met de tekstvelden type en value en een verzameling options met het tekstveld ai_mode. Stel type in op email en ai_mode op off, en koppel daarna het e-mailadres van de klant aan value.
- Activeer Parse response. Een body die met een gegevensstructuur in Make is gemaakt, serialiseert de gekoppelde waarden als JSON, zodat namen of adressen met aanhalingstekens geen handmatige tekstsamenvoeging vereisen.
| 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
Laat omleidingen uitgeschakeld voor deze vaste HTTPS-bestemming van de API. Controleer de instellingen voor authenticatie en de body van het verzoek opnieuw als u van versie van de HTTP-app van Make wisselt: de bedieningselementen kunnen verschillen.
Voer een beperkte test uit, bekijk de bundle van het geanalyseerde antwoord en maak afzonderlijke routes voor geaccepteerde identified-resultaten, unknown-resultaten en operationele fouten voordat u de klantupdate toevoegt.
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
Koppel de hierboven genoemde paden van de V2-body in het geanalyseerde HTTP-antwoord. Make kan de body onder een outputlabel van de module plaatsen: kies de geneste objecten data en meta uit de bekeken bundle. Werk alleen de klant bij wiens ID door de trigger is opgeslagen, in een apart veld voor afgeleide gegevens of volgens een vastgesteld beleid voor tags.
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 de foutafhandelaars van Make en de instellingen voor onvolledige uitvoeringen. Sommige tijdelijke fouten kunnen ook zonder expliciete afhandeling van nieuwe pogingen worden herhaald. Een nieuwe poging in de HTTP-module kan een extra betaald verzoek versturen. Als het verzoek is geslaagd maar de volgende update in Shopify niet, gebruik dan de opgeslagen output om die update te corrigeren.
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
Moet ik de API-sleutel in Make in de URL zetten?
Nee. Sla in de HTTP-configuratie voor V2 Bearer YOUR_API_KEY op in referenties van het type API key, met de locatie Header en Authorization als parameternaam. Het POST-endpoint accepteert geen queryparameter key.
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.