# Migrujte ze GenderAPI v1 na v2

> Přesuňte integraci GenderAPI z v1 na v2 pomocí stejného klíče a vyvážení API. Mapujte pole požadavků, dávkové trasy, odpovědi, chyby a chování opakování.

Canonical HTML: https://www.genderapi.io/cs/docs/v2/migration

Last reviewed: 2026-09-25

## 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 |

- [Přečtěte si referenci v1](https://www.genderapi.io/cs/api-documentation/v1)
- [Použijte smlouvu v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## 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.

- [Začněte s ověřováním](https://www.genderapi.io/cs/docs/v2/authentication)
- [Přečtěte si odpověď v2](https://www.genderapi.io/cs/docs/v2/responses)
- [Opakujte pokusy](https://www.genderapi.io/cs/docs/v2/errors-and-retries)