Flytta en integration från v1 till v2
V1 förblir tillgänglig. Migrera individuella integrationer när du är klar med samma nyckel och kreditsaldo. V2 är ett annat förfrågnings- och svarskontrakt, så det räcker inte att bara ändra webbadressen.
| V1 koncept | V2 ekvivalent |
|---|---|
| Separata slutpunkter för namn, e-post och användarnamn | POST /api/v2/gender med type och value |
| Separera flera ändpunkter | POST /api/v2/gender/batch med items |
| askToAI | options.ai_mode: fallback; enstaka förfrågningar är redan fallback som standard |
| forceToGenderize | Samma valfria fält för alla tre typerna; dataset först, sedan smeknamnsmedveten AI |
| Platta svarsfält | data för resultatet; meta för åtkomst och fakturering |
| probability procent | confidence på en skala 0–1 plus confidence_kind; AI-poäng är inte kalibrerade sannolikheter |
| total_names | data.sample_count, nullbar |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Äldre felformat | HTTP status plus Problem Details code och action |
| POST försöker igen | Varje nytt försök är en ny operation med normal fakturering |
Uppdatera och verifiera din klient
Använd v2-begäran och svarskontraktet för integrationen du migrerar. Verifiera meta.access.mode, bevara JSON null-resultat, inspektera batchfel per artikel och kontrollera faktureringen innan du försöker igen. Behåll v1-integrationer på sina befintliga vägar tills deras klienter har uppdaterats.