Flytt en integrasjon fra v1 til v2
V1 forblir tilgjengelig. Migrer individuelle integrasjoner når du er klar med samme nøkkel og kredittsaldo. V2 er en annen forespørsels- og svarkontrakt, så det er ikke tilstrekkelig å endre bare URL-en.
| V1 konsept | V2 ekvivalent |
|---|---|
| Separate endepunkter for navn, e-post og brukernavn | POST /api/v2/gender med type og value |
| Skill flere endepunkter | POST /api/v2/gender/batch med items |
| askToAI | options.ai_mode: fallback; enkeltforespørsler er allerede standard til fallback |
| forceToGenderize | Samme valgfrie felt for alle tre typene; datasett først, deretter kallenavn-bevisst KI |
| Flate svarfelt | data for resultatet; meta for tilgang og fakturering |
| probability prosentandel | confidence på en skala 0–1 pluss confidence_kind; KI-poengsum er ikke kalibrerte sannsynligheter |
| total_names | data.sample_count, nullbar |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Eldre feilformat | HTTP status pluss Problem Details code og action |
| POST prøver på nytt | Hvert nytt forsøk er en ny operasjon med normal fakturering |
Oppdater og bekreft klienten din
Bruk v2-forespørsels- og svarkontrakten for integrasjonen du migrerer. Bekreft meta.access.mode, bevar JSON null-resultater, inspiser batchfeil per vare og kontroller fakturering før du prøver på nytt. Behold v1-integrasjoner på deres eksisterende baner til klientene deres har blitt oppdatert.