Find køn via navn – Enkelt forespørgsel

Slutpunktet Find køn via navn gør det muligt at bestemme kønnet på et enkelt fornavn. Alle parametre sendes via en POST-anmodning som JSON. Du skal autentificere dig med Bearer-tokenmetoden i Authorization-headeren.

Anmodnings-URL

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

Nødvendige HTTP-headere

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

Parametre til request body

Parameter Type Påkrævet Beskrivelse
name String Ja Fornavnet du vil analysere. Skal være ét enkelt ord uden titler eller præfikser.
country String Nej En to-bogstavs landekode (ISO 3166-1 alpha-2) for at øge præcisionen. Eksempel: TR for Tyrkiet.
askToAI Boolean Nej Hvis sat til true, vil API’et spørge en AI-model, hvis navnet ikke findes i databasen.
forceToGenderize Boolean Nej Hvis sat til true, vil API’et forsøge at gætte kønnet, selv hvis input ikke ligner et menneskeligt navn, som fx brugernavne eller fantasifulde udtryk (fx sparkling unicorn).

Eksempel på forespørgsler


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"
}

Svarsfelter

Felt Type Beskrivelse
status Boolean Angiver om forespørgslen var succesfuld.
used_credits Integer Antal kreditter brugt til denne forespørgsel.
remaining_credits Integer Kreditter tilbage på din konto efter denne forespørgsel.
expires Integer (timestamp) Pakkens udløbsdato som UNIX timestamp.
q String Din inputforespørgsel (navnet sendt).
name String Det analyserede eller udtrukne fornavn.
gender Enum[String] Forudsagt køn. Mulige værdier: male, female eller null.
country String Landekoden, der blev taget i betragtning under forudsigelsen.
total_names Integer Antal prøver brugt til denne forudsigelse.
probability Integer Sikkerhedsprocent for kønsforudsigelsen.
duration String Tid brugt på at behandle forespørgslen (f.eks. 4ms).
Advarsel: Sørg altid for, at inputværdier som navne ikke indeholder uventede tegn. Hvis du planlægger at bruge specialtegn eller mellemrum, så sørg for korrekt JSON-kodning for at undgå fejl.