Flytt en integrasjon fra V1 til V2
V1 er fortsatt tilgjengelig. Flytt enkeltintegrasjoner når du er klar, med den samme nøkkelen og kredittsaldoen. V2 har en annen kontrakt for forespørsler og svar, så det holder ikke å bare endre 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; inndatatypene kan kombineres. |
| /api/phone med number og address | POST /api/v2/phone/validate med number og country; les data.valid og data.possible. |
| askToAI | options.ai_mode: fallback; enkeltforespørsler bruker allerede fallback som standard |
| forceToGenderize | Det samme valgfrie feltet for alle tre typene; datasettet først, deretter KI som tolker kallenavn |
| Flate svarfelt | data for resultatet; meta for tilgang og belastning |
| probability i prosent | confidence på en skala fra 0 til 1 og confidence_kind; KI-verdier er ikke kalibrerte sannsynligheter |
| total_names | data.sample_count, kan være null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Eldre feilformat | HTTP-status og code og action fra Problem Details |
| Nye POST-forsøk | Hvert nytt forsøk er en ny operasjon med vanlig belastning |
Oppdater og kontroller klienten
Bruk kontrakten for forespørsler og svar i V2 for integrasjonen du flytter. Kontroller meta.access.mode, behold JSON null-resultater, kontroller feil per element i samleforespørsler, og sjekk belastningen før du prøver på nytt. La V1-integrasjoner bruke de eksisterende stiene til klientene deres er oppdatert.