# Migreren van GenderAPI v1 naar v2

> Verplaats een GenderAPI-integratie van v1 naar v2 met dezelfde API-sleutel en balans. Breng aanvraagvelden, batchroutes, reacties, fouten en gedrag voor nieuwe pogingen in kaart.

Canonical HTML: https://www.genderapi.io/nl/docs/v2/migration

Last reviewed: 2026-09-25

## Verplaats een integratie van v1 naar v2

V1 blijft beschikbaar. Migreer individuele integraties wanneer u klaar bent met dezelfde sleutel en hetzelfde tegoed. V2 is een ander request-and-response-contract, dus alleen de URL wijzigen is niet voldoende.

| V1-concept | V2-equivalent |
| --- | --- |
| Aparte eindpunten voor naam, e-mailadres en gebruikersnaam | POST /api/v2/gender met type en value |
| Scheid meerdere eindpunten | POST /api/v2/gender/batch met items |
| askToAI | options.ai_mode: fallback; enkele verzoeken zijn al standaard ingesteld op fallback |
| forceToGenderize | Hetzelfde optionele veld voor alle drie de typen; eerst de dataset en daarna de bijnaambewuste AI |
| Platte responsvelden | data voor het resultaat; meta voor toegang en facturering |
| probability-percentage | confidence op een schaal van 0–1 plus confidence_kind; AI-scores zijn geen gekalibreerde kansen |
| total_names | data.sample_count, nullbaar |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Verouderd foutformaat | HTTP-status plus Problem Details code en action |
| POST nieuwe poging | Elke nieuwe poging is een nieuwe handeling met normale facturering |

- [Lees de v1-referentie](https://www.genderapi.io/nl/api-documentation/v1)
- [Gebruik het v2 OpenAPI-contract](https://api.genderapi.io/api/v2/openapi.json)

## Update en verifieer uw client

Gebruik het v2 request and response-contract voor de integratie die u migreert. Verifieer meta.access.mode, bewaar JSON null-resultaten, inspecteer batchfouten per item en controleer de facturering voordat u het opnieuw probeert. Houd v1-integraties op hun bestaande paden totdat hun clients zijn bijgewerkt.

- [Begin met authenticatie](https://www.genderapi.io/nl/docs/v2/authentication)
- [Lees een v2-antwoord](https://www.genderapi.io/nl/docs/v2/responses)
- [Nieuwe pogingen verwerken](https://www.genderapi.io/nl/docs/v2/errors-and-retries)