# Integrately koppelen aan GenderAPI.io V2

> Koppel Integrately aan GenderAPI.io V2 voor records in Mailchimp. Kies de juiste connector, verstuur type en value en verwerk daarna data, meta, credits en fouten.

Canonical HTML: https://www.genderapi.io/nl/blog/integrately-gender-api-integration

Last reviewed: 2026-09-28

## Kies de Integrately-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 GenderAPI.io-pagina op Integrately verwijst naar genderapi.io en biedt acties voor namen, e-mailadressen en voor het extraheren van de naam uit een e-mailadres. Ze vermeldt noch de versie van de onderliggende API noch het volledige schema van de output; de namen van de acties volstaan op zichzelf niet om compatibiliteit met V2 te bevestigen.

Integrately documenteert Webhook/API als uitgaande POST-actie. De huidige bedieningselementen voor headers en de JSON-editor zijn voor deze handleiding niet onafhankelijk gecontroleerd. Pas het V2-HTTP-contract hieronder alleen toe nadat u hebt bevestigd dat uw actie een Authorization-header en een geneste JSON-body kan versturen. Bestaande native acties behouden hun eigen veldcontract.

- [GenderAPI.io-pagina op Integrately](https://integrately.com/integrations/genderapi-io)
- [Bestaande V1-documentatie](https://www.genderapi.io/nl/api-documentation/v1)

## Bereid het account en het bronrecord voor

Dit voorbeeld verrijkt records in Mailchimp 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](https://www.genderapi.io/nl/docs/v2/authentication#environment-setup)

## Het GenderAPI.io V2-verzoek configureren in Integrately

- Kies een Mailchimp-trigger voor abonnees en controleer een testrecord. Sla de ID van het publiek (Audience) en van de abonnee op voor de update, kies het daadwerkelijke naamveld en sla records zonder naam over.
- Zoek Webhook/API en de bijbehorende actie om gegevens naar een URL te versturen. Controleer de beschikbare configuratie voordat u verdergaat: het contract hieronder vereist geauthenticeerde headers en een geneste JSON-body, en de huidige bedieningselementen van de editor zijn hier niet onafhankelijk gecontroleerd.
- Als de actie aan deze vereisten voldoet, kies dan POST en het V2-endpoint hieronder. Zorg er met de bedieningselementen die in uw account beschikbaar zijn voor dat het uitgaande verzoek Authorization: Bearer YOUR_API_KEY en Content-Type: application/json bevat.
- Maak een JSON-body met type = name, value = gekoppelde naam en options met ai_mode = off. Controleer de voorvertoning van het verzoek voor de gekozen actie: een platte formulierpayload is geen V2-JSON-body, ook niet als de header Content-Type is ingesteld.
- Gebruik voor dynamische namen de koppelings- of JSON-serialisatieopties van het platform. Als de gekozen actie geen geneste JSON of geauthenticeerde headers kan behouden, gebruik dan een stap met HTTP-ondersteuning in plaats van de sleutel of de JSON in queryparameters te zetten.

| 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.

**V2-JSON-verzoek voor Integrately**

```json
{
  "type": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}
```

- [Velden, typen en standaardwaarden van het verzoek](https://www.genderapi.io/nl/docs/v2/request-parameters)

## Controleer de HTTP-stap voordat u updates inschakelt

Test een actie op beperkte schaal en bekijk de teruggegeven body voordat u velden in de volgende stappen kiest. Native GenderAPI.io-stappen en Webhook/API-stappen kunnen verschillende veldlabels tonen, ook voor dezelfde bronklant.

Bewaar de sleutel in de bedieningselementen die voor de verbinding of voor de authenticatie van het verzoek zijn bedoeld, en beperk wie de automatisering kan bekijken of delen. Deze openbare handleiding bevat geen werkende sleutel, geen geëxporteerde verbinding en geen vooraf geconfigureerde klantupdate.

- [Webhook/API-acties in Integrately](https://integrately.com/integrations/webhook-api)
- [Documentatie van Integrately](https://integrately.com/docs)

## 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. |

- [Volledige documentatie van het V2-antwoord](https://www.genderapi.io/nl/docs/v2/responses)
- [Fouten, time-outs en beslissingen over nieuwe pogingen](https://www.genderapi.io/nl/docs/v2/errors-and-retries)

## Werk in Mailchimp alleen het bijbehorende record bij

Gebruik de opgeslagen Mailchimp-ID's van het publiek (Audience) en van de abonnee om het doelrecord te kiezen. Voeg voorwaarden toe voor de resultaatstatus en voor de hierboven beschreven controles van toegang en afschrijving voordat u de gegevens naar een apart veld voor afgeleide gegevens of naar een goedgekeurde tag schrijft. Zet een ontbrekend geslacht of de waarde null nooit om in een standaardcategorie van het contact.

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.

- [Antwoordvelden en onbekende resultaten](https://www.genderapi.io/nl/docs/v2/responses)
- [Nauwkeurigheid en betrouwbaarheidsscore uitgelegd](https://www.genderapi.io/nl/accuracy-methodology)
- [Gegevensbronnen en gedateerd profiel van de database](https://www.genderapi.io/nl/data-provenance)

## Nieuwe pogingen en herhaalde afschrijvingen beheersen

Integrately documenteert automatische nieuwe pogingen, inclusief instellingen die voor het hele bedrijf gelden. Controleer het beleid en de taakgeschiedenis voordat u deze automatisering activeert, en beoordeel de gevolgen voor andere workflows voordat u een gedeelde instelling wijzigt. Elk herhaald HTTP-verzoek is een afzonderlijk verzoek dat wordt afgeschreven; sla geslaagde outputs op zodat u een latere fout in Mailchimp zonder nieuw verzoek kunt 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.

- [Credits en afschrijvingsstatus](https://www.genderapi.io/nl/docs/v2/credits-and-usage)

## 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 |

- [AI-opties en bijnaaminterpretatie](https://www.genderapi.io/nl/docs/v2/ai-options)
- [Credits en gebruik](https://www.genderapi.io/nl/docs/v2/credits-and-usage)

## 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.

- [Batches en fouten bij afzonderlijke items](https://www.genderapi.io/nl/docs/v2/batch)
- [Implementatiehandleiding voor Python](https://www.genderapi.io/nl/integrations/python)
- [Implementatiehandleiding voor Node.js](https://www.genderapi.io/nl/integrations/javascript)

## Kan ik het veld probability van de oude native actie koppelen aan het V2-veld confidence?

Controleer eerst het contract van het antwoord. Een direct V2-verzoek geeft data.confidence samen met data.confidence_kind terug, op een schaal van 0 tot 1 of null. Niets ondersteunt de aanname dat de labels en de schaal van de velden van de native connector overeenkomen met deze paden.

## 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

- [GenderAPI.io-pagina op Integrately](https://integrately.com/integrations/genderapi-io)
- [Webhook/API-acties in Integrately](https://integrately.com/integrations/webhook-api)
- [Documentatie van Integrately](https://integrately.com/docs)
- [Verzoekcontract van GenderAPI.io V2](https://www.genderapi.io/nl/docs/v2/request-parameters)
- [Antwoordcontract van GenderAPI.io V2](https://www.genderapi.io/nl/docs/v2/responses)
- [Afschrijvingen en credits in GenderAPI.io V2](https://www.genderapi.io/nl/docs/v2/credits-and-usage)