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.