Zjištění pohlaví podle jména – Jednotlivý požadavek

Endpoint Zjištění pohlaví podle jména vám umožní určit pohlaví jednoho křestního jména. Všechny parametry jsou odesílány v POST požadavku jako JSON. Musíte se ověřit pomocí Bearer tokenu v hlavičce Authorization.

URL požadavku

POST https://api.genderapi.io/api

Povinné HTTP hlavičky

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

Parametry těla požadavku

Parametr Typ Povinné Popis
name Řetězec Ano Křestní jméno, které chcete analyzovat. Musí být jedno slovo bez titulů nebo předpon.
country Řetězec Ne Dvoupísmenný kód země (ISO 3166-1 alpha-2) pro vyšší přesnost predikce. Například: TR pro Turecko.
askToAI Boolean Ne Pokud je nastaveno na true, API použije AI model k určení pohlaví, pokud dané jméno nenajde v databázi.
forceToGenderize Boolean Ne Pokud je nastaveno na true, API se pokusí určit pohlaví i u výrazů, které nejsou typická lidská jména, například přezdívky nebo fantazijní pojmenování (např. sparkling unicorn).

Příklady požadavků


cURL příklad

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"name": "Alice", "country": "US", "askToAI": true, "forceToGenderize": true}'

PHP cURL příklad

<?php
$url = "https://api.genderapi.io/api";

$data = array(
    "name" => "Alice",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

JavaScript fetch příklad

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests příklad


import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Příklad JSON odpovědi

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "Alice",
  "name": "Alice",
  "gender": "female",
  "country": "US",
  "total_names": 10234,
  "probability": 98,
  "duration": "4ms"
}

Pole odpovědi

Pole Typ Popis
status Boolean Označuje, zda byl požadavek úspěšný.
used_credits Integer Počet kreditů spotřebovaných tímto požadavkem.
remaining_credits Integer Zbývající kredity na účtu po tomto požadavku.
expires Integer (timestamp) Datum expirace balíčku ve formátu UNIX timestamp.
q Řetězec Váš zadaný dotaz (odeslané jméno).
name Řetězec Analyzované nebo extrahované křestní jméno.
gender Enum[String] Předpokládané pohlaví. Možné hodnoty: male, female nebo null.
country Řetězec Kód země použitý při predikci.
total_names Integer Počet vzorků použitých pro tuto predikci.
probability Integer Procento důvěry v predikci pohlaví.
duration Řetězec Čas zpracování požadavku (např. 4ms).
Upozornění: Vždy se ujistěte, že vstupní hodnoty jako jména neobsahují neočekávané znaky. Pokud plánujete používat speciální znaky nebo mezery, ujistěte se, že je vstup správně JSON zakódován, abyste předešli chybám.