Flyt en integration fra v1 til v2
V1 forbliver tilgængelig. Migrer individuelle integrationer, når du er klar, ved at bruge den samme nøgle og kreditsaldo. V2 er en anden anmodnings- og svarkontrakt, så det er ikke tilstrækkeligt at ændre kun URL'en.
| V1 koncept | V2 ækvivalent |
|---|---|
| Adskil navn, e-mail og brugernavn slutpunkter | POST /api/v2/gender med type og value |
| Adskil flere endepunkter | POST /api/v2/gender/batch med items |
| askToAI | options.ai_mode: fallback; enkelte anmodninger er allerede standard til fallback |
| forceToGenderize | Samme valgfri felt for alle tre typer; datasæt først, derefter kaldenavn-bevidst AI |
| Flade svarfelter | data for resultatet; meta til adgang og fakturering |
| probability procent | confidence på en 0-1 skala plus confidence_kind; AI-score er ikke kalibrerede sandsynligheder |
| total_names | data.sample_count, nullbar |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Ældre fejlformat | HTTP status plus Problem Details code og action |
| POST forsøger igen | Hvert genforsøg er en ny operation med normal fakturering |
Opdater og bekræft din klient
Brug v2-anmodnings- og svarkontrakten til den integration, du migrerer. Bekræft meta.access.mode, bevar JSON null resultater, inspicér batchfejl pr. vare, og kontroller fakturering, før du prøver igen. Hold v1-integrationer på deres eksisterende stier, indtil deres klienter er blevet opdateret.