Přesuňte integraci z v1 na v2
V1 zůstává k dispozici. Až budete připraveni, proveďte migraci jednotlivých integrací pomocí stejného klíče a zůstatku kreditu. V2 je jiná smlouva na požadavek a odpověď, takže změna pouze adresy URL nestačí.
| Koncept V1 | ekvivalent V2 |
|---|---|
| Oddělte koncové body názvu, e-mailu a uživatelského jména | POST /api/v2/gender s type a value |
| Oddělte více koncových bodů | POST /api/v2/gender/batch s items |
| askToAI | options.ai_mode: fallback; jednotlivé požadavky jsou již standardně nastaveny na fallback |
| forceToGenderize | Stejné nepovinné pole pro všechny tři typy; nejprve datová sada, poté AI s ohledem na přezdívky |
| Plochá pole odezvy | data pro výsledek; meta pro přístup a účtování |
| probability procento | confidence na stupnici 0–1 plus confidence_kind; Skóre AI nejsou kalibrované pravděpodobnosti |
| total_names | data.sample_count, s možností null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Starší formát chyby | Stav HTTP plus Problem Details code a action |
| POST se znovu pokusí | Každý opakovaný pokus je nová operace s normálním účtováním |
Aktualizujte a ověřte svého klienta
Pro integraci, kterou migrujete, použijte smlouvu o požadavku a odpovědi v2. Před dalším pokusem ověřte meta.access.mode, zachovejte výsledky JSON null, zkontrolujte chyby v dávce u jednotlivých položek a zkontrolujte účtování. Ponechat integrace v1 na jejich stávajících cestách, dokud nebudou jejich klienti aktualizováni.