Een integratie van V1 naar V2 overzetten
GenderAPI.io V1 blijft beschikbaar. Zet elke integratie over naar V2 met dezelfde API-sleutel en hetzelfde creditsaldo. V2 heeft een ander contract voor verzoeken en antwoorden, dus alleen de URL wijzigen is niet genoeg: werk routes, verzoekvelden en de verwerking van antwoorden samen bij. V2 gebruikt data voor de resultaten en meta voor informatie over verzoek, toegang en afschrijving.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender met type: name, email of username en value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch met items; invoertypen kunnen worden gecombineerd. |
| /api/phone met number en address | POST /api/v2/phone/validate met number en country; lees data.valid en data.possible. |
| askToAI | options.ai_mode: fallback; losse verzoeken gebruiken standaard al fallback |
| forceToGenderize | Hetzelfde optionele veld voor alle drie de typen; eerst de dataset, daarna AI met bijnaaminterpretatie |
| Niet-geneste antwoordvelden | data voor het resultaat; meta voor toegang en afschrijving |
| probability als percentage | confidence op een schaal van 0 tot 1 plus confidence_kind; AI-scores zijn geen gekalibreerde kansen |
| total_names | data.sample_count, kan null zijn |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Eerder foutformaat | HTTP-status plus code en action van Problem Details |
| Nieuwe pogingen bij POST | Elke nieuwe poging is een nieuwe bewerking met normale afschrijving |
De client bijwerken en controleren
Gebruik het contract voor verzoeken en antwoorden van V2 voor de integratie die u overzet. Controleer meta.access.mode, behoud JSON-resultaten met null, controleer de fouten van afzonderlijke items in batches en controleer de afschrijving voordat u het opnieuw probeert. Laat V1-integraties op hun huidige paden staan totdat de bijbehorende clients zijn bijgewerkt.