# Dokumentace GenderAPI.io V2

> Odešlete první požadavek, připojte svou aplikaci a naučte se číst výsledky. Začněte jménem, e-mailovou adresou nebo uživatelským jménem.

Canonical HTML: https://www.genderapi.io/cs/api-documentation

Last reviewed: 2026-09-30

## Odešlete první požadavek

Odešlete jméno, e-mailovou adresu nebo uživatelské jméno a získejte odhad pohlaví ve formátu JSON. Vyzkoušejte níže uvedenou URL v prohlížeči bez API klíče a potom vyberte průvodce pro připojení své aplikace.

Bezplatný zkušební režim podle IP nabízí 10 kreditů na IP adresu za 24 hodin a sdílí je s V1. Tento příklad používá pouze datovou sadu a stojí 1 kredit za každý požadavek, včetně každého obnovení stránky. Když použijete svůj stávající API klíč, V1 a V2 čerpají ze stejného zůstatku účtu.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Lucie&country=CZ&ai_mode=off
```

- [Otevřít příklad GET (spotřebuje 1 kredit ze zkušebního režimu podle IP)](https://api.genderapi.io/api/v2/gender?type=name&value=Lucie&country=CZ&ai_mode=off)
- [Nastavte API klíč](https://www.genderapi.io/cs/docs/v2/authentication#environment-setup)
- [Porozumějte odpovědi JSON](https://www.genderapi.io/cs/docs/v2/responses)

## Co chcete udělat?

Vyberte typ vstupu a získejte funkční příklady v cURL, JavaScriptu, Pythonu, PHP, Javě, C# a Go. Až budete zpracovávat skutečné odpovědi, použijte průvodce výsledky a účtováním.

- [API klíč a bezplatný zkušební režim podle IP](https://www.genderapi.io/cs/docs/v2/authentication): Připojte svůj API klíč, nebo API vyzkoušejte zdarma.
- [Parametry požadavku](https://www.genderapi.io/cs/docs/v2/request-parameters): Vyberte vstupní pole, kontext země a možnosti požadavku.
- [Oficiální SDK](https://www.genderapi.io/cs/docs/v2/sdks): Nainstalujte oficiálního klienta pro svůj programovací jazyk.
- [Pohlaví podle jména](https://www.genderapi.io/cs/docs/v2/gender-from-name): Vyhledejte křestní nebo celé jméno.
- [Pohlaví podle e-mailu](https://www.genderapi.io/cs/docs/v2/gender-from-email): Najděte jmenný signál v e-mailové adrese.
- [Pohlaví podle uživatelského jména](https://www.genderapi.io/cs/docs/v2/gender-from-username): Použijte jako vstup uživatelské jméno nebo přezdívku.
- [Dávkové požadavky (batch)](https://www.genderapi.io/cs/docs/v2/batch): Zpracujte najednou až 50 jmen, e-mailových adres nebo uživatelských jmen.
- [Ověření telefonního čísla](https://www.genderapi.io/cs/docs/v2/phone-validation): Zkontrolujte a naformátujte telefonní číslo.
- [Čtení odpovědi](https://www.genderapi.io/cs/docs/v2/responses): Čtěte odhady, míru spolehlivosti a neznámé výsledky.
- [AI a přezdívky](https://www.genderapi.io/cs/docs/v2/ai-options): Rozhodněte, kdy použít AI a jak zacházet s přezdívkami.
- [Kredity a zůstatek](https://www.genderapi.io/cs/docs/v2/credits-and-usage): Zkontrolujte zůstatek a cenu jednotlivých požadavků.
- [Chyby a opakování požadavků](https://www.genderapi.io/cs/docs/v2/errors-and-retries): Řešte chyby a rozhodněte, kdy požadavek zopakovat.
- [Přechod z V1 na V2](https://www.genderapi.io/cs/docs/v2/migration): Aktualizujte stávající integraci se stejným API klíčem.

## Přehled endpointů

Spojte https://api.genderapi.io s absolutními cestami v této tabulce. Například: https://api.genderapi.io/api/v2/gender. Parametry dotazu v URL podporuje pouze GET /gender. U cest POST posílejte tělo JSON a v požadavku V2 neposílejte pole z V1, jako jsou name, email, username nebo askToAI.

| Metoda | Cesta | Účel |
| --- | --- | --- |
| GET | /api/v2 | Veřejné možnosti a aktuální limity; zdarma. |
| GET | /api/v2/openapi.json | Kanonická specifikace OpenAPI; zdarma. |
| GET | /api/v2/errors | Strojově čitelný katalog chyb; zdarma. |
| GET | /api/v2/usage | Aktuální zůstatek účtu nebo zkušebního režimu podle IP; zdarma. |
| GET / POST | /api/v2/gender | Jedno jméno, e-mailová adresa nebo uživatelské jméno. |
| POST | /api/v2/gender/batch | Seřazená dávka jmen, e-mailových adres a/nebo uživatelských jmen. |
| POST | /api/v2/phone/validate | Ověřte a naformátujte telefonní číslo. |