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