Flyt en integration fra V1 til V2
V1 er fortsat tilgængelig. Flyt de enkelte integrationer, når du er klar, med den samme nøgle og kreditsaldo. V2 har en anden kontrakt for forespørgsler og svar, så det er ikke nok kun at ændre URL'en.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender med type: name, email eller username og value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch med items. Inputtyperne kan kombineres. |
| /api/phone med number og address | POST /api/v2/phone/validate med number og country. Læs data.valid og data.possible. |
| askToAI | options.ai_mode: fallback. Enkeltforespørgsler bruger allerede fallback som standard |
| forceToGenderize | Samme valgfrie felt for alle tre typer. Datasættet først og derefter AI, der tager højde for kaldenavne |
| Flade felter i svaret | data til resultatet, meta til adgang og opkrævning |
| probability i procent | confidence på en skala fra 0 til 1 samt confidence_kind. AI-værdier er ikke kalibrerede sandsynligheder |
| total_names | data.sample_count, kan være null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Ældre fejlformat | HTTP-status samt code og action fra Problem Details |
| Nye forsøg med POST | Hvert nyt forsøg er en ny operation, der opkræves normalt |
Opdater og kontrollér din klient
Brug V2's kontrakt for forespørgsler og svar i den integration, du flytter. Kontrollér meta.access.mode, bevar resultater med JSON null, kontrollér fejl for hvert element i batches, og kontrollér opkrævningen, før du prøver igen. Lad V1-integrationer blive på deres eksisterende stier, indtil deres klienter er opdateret.