Hent Kjønn via Navn – Enkeltforespørsel
Endepunktet Get Gender by Name lar deg bestemme kjønn basert på ett enkelt fornavn. Alle parametere sendes via en POST-forespørsel som JSON. Du må autentisere deg med Bearer-token-metoden i Authorization-headeren.
Forespørsels-URL
POST https://api.genderapi.io/api
Nødvendige HTTP-headere
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
Parametere i Forespørselsbody
Parameter | Type | Påkrevd | Beskrivelse |
---|---|---|---|
name | String | Ja | Fornavnet du ønsker å analysere. Må være ett enkelt ord uten titler eller prefikser. |
country | String | Nei |
En tobokstavs landskode (ISO 3166-1 alpha-2) som kan forbedre nøyaktigheten.
Eksempel: TR for Tyrkia.
|
askToAI | Boolean | Nei |
Hvis satt til true , vil API-et spørre en AI-modell for å avgjøre kjønn dersom navnet ikke finnes
i databasen.
|
forceToGenderize | Boolean | Nei |
Hvis satt til true , vil API-et forsøke å gjette kjønn selv for input som ikke er vanlige menneskenavn,
som kallenavn eller fantasinavn (f.eks. sparkling unicorn ).
|
Eksempler på Forespørsler
cURL-eksempel
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-eksempel
<?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-eksempel
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-eksempel
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())
Eksempel på JSON-svar
{
"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"
}
Felter i Svar
Felt | Type | Beskrivelse |
---|---|---|
status | Boolean | Indikerer om forespørselen var vellykket. |
used_credits | Integer | Antall kreditter brukt for denne forespørselen. |
remaining_credits | Integer | Kreditter som gjenstår på kontoen din etter forespørselen. |
expires | Integer (timestamp) | Dato for når pakken utløper, som UNIX-timestamp. |
q | String | Din innsendte forespørsel (navnet du sendte inn). |
name | String | Navnet som ble analysert eller hentet ut. |
gender | Enum[String] | Predikert kjønn. Mulige verdier: male , female eller null . |
country | String | Landskoden som ble tatt hensyn til under prediksjonen. |
total_names | Integer | Antall navneprøver brukt for denne prediksjonen. |
probability | Integer | Sannsynlighetsprosent for kjønnsprediksjonen. |
duration | String | Tiden brukt på å behandle forespørselen (f.eks. 4ms ). |
Advarsel:
Sørg alltid for at inndata som navn ikke inneholder uventede tegn.
Hvis du planlegger å bruke spesialtegn eller mellomrom, må du sikre korrekt JSON-koding for å unngå feil.