# Przeprowadź migrację z GenderAPI v1 do v2

> Przenieś integrację GenderAPI z wersji 1 do wersji 2, używając tego samego klucza i balansu API. Mapuj pola żądań, trasy wsadowe, odpowiedzi, błędy i zachowanie ponawiania prób.

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

Last reviewed: 2026-09-25

## Przenieś integrację z wersji 1 do wersji 2

Wersja 1 pozostaje dostępna. Przeprowadź migrację poszczególnych integracji, gdy będą gotowe, przy użyciu tego samego klucza i salda środków. Wersja 2 to inny kontrakt żądania i odpowiedzi, więc zmiana samego adresu URL nie wystarczy.

| Koncepcja V1 | Odpowiednik V2 |
| --- | --- |
| Oddzielne punkty końcowe zawierające nazwę, adres e-mail i nazwę użytkownika | POST /api/v2/gender z type i value |
| Oddziel wiele punktów końcowych | POST /api/v2/gender/batch z items |
| askToAI | options.ai_mode: fallback; pojedyncze żądania są już domyślnie ustawione na fallback |
| forceToGenderize | To samo pole opcjonalne dla wszystkich trzech typów; najpierw zbiór danych, a następnie sztuczna inteligencja rozpoznająca pseudonimy |
| Płaskie pola odpowiedzi | data dla wyniku; meta dla dostępu i rozliczeń |
| probability procent | confidence w skali 0–1 plus confidence_kind; Wyniki AI nie są skalibrowanymi prawdopodobieństwami |
| total_names | data.sample_count, dopuszczający wartość null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Starszy format błędu | Stan HTTP plus Problem Details code i action |
| POST ponawia próbę | Każda ponowna próba to nowa operacja z normalnym rozliczeniem |

- [Przeczytaj odniesienie do wersji 1](https://www.genderapi.io/pl/api-documentation/v1)
- [Użyj kontraktu v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## Zaktualizuj i zweryfikuj swojego klienta

Użyj umowy żądań i odpowiedzi w wersji 2 dla integracji, którą migrujesz. Zweryfikuj meta.access.mode, zachowaj wyniki JSON null, sprawdź błędy wsadowe poszczególnych pozycji i sprawdź rozliczenia przed ponowną próbą. Zachowaj integracje v1 na istniejących ścieżkach, dopóki ich klienci nie zostaną zaktualizowani.

- [Zacznij od uwierzytelnienia](https://www.genderapi.io/pl/docs/v2/authentication)
- [Przeczytaj odpowiedź v2](https://www.genderapi.io/pl/docs/v2/responses)
- [Obsługa ponownych prób](https://www.genderapi.io/pl/docs/v2/errors-and-retries)