Převeďte integraci z V1 na V2
V1 zůstává k dispozici. Jednotlivé integrace převeďte, až budete připraveni, se stejným klíčem a zůstatkem kreditů. V2 má jiný formát požadavků a odpovědí, takže nestačí změnit jen URL.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender s type: name, email nebo username a value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch s items; typy vstupu lze kombinovat. |
| /api/phone s number a address | POST /api/v2/phone/validate s number a country; čtěte data.valid a data.possible. |
| askToAI | options.ai_mode: fallback; jednotlivé požadavky už mají fallback jako výchozí |
| forceToGenderize | Stejné volitelné pole pro všechny tři typy; nejprve datová sada, poté AI s analýzou přezdívek |
| Plochá pole odpovědi | data pro výsledek; meta pro přístup a účtování |
| probability v procentech | confidence na stupnici 0–1 a confidence_kind; skóre AI nejsou kalibrované pravděpodobnosti |
| total_names | data.sample_count, může být null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Starší formát chyb | Stav HTTP a code a action z Problem Details |
| Opakování požadavků POST | Každé opakování je nová operace s běžným účtováním |
Aktualizujte a ověřte svého klienta
U převáděné integrace používejte formát požadavků a odpovědí V2. Ověřte meta.access.mode, zachovejte výsledky JSON null, kontrolujte chyby jednotlivých položek dávky a před opakováním zkontrolujte účtování. Integrace V1 ponechte na jejich stávajících cestách, dokud nebudou jejich klienti aktualizováni.