Λήψη Φύλου μέσω Ονόματος – Μονό Αίτημα

Το endpoint Λήψη Φύλου μέσω Ονόματος σας επιτρέπει να προσδιορίσετε το φύλο ενός μόνο ονόματος. Όλες οι παράμετροι αποστέλλονται μέσω ενός POST αιτήματος ως JSON. Η ταυτοποίηση γίνεται με Bearer token στη κεφαλίδα Authorization.

Διεύθυνση Αιτήματος (Request URL)

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

Απαραίτητες Κεφαλίδες HTTP

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

Παράμετροι Request Body

Παράμετρος Τύπος Υποχρεωτικό Περιγραφή
name String Ναι Το όνομα που θέλετε να αναλύσετε. Πρέπει να είναι μια λέξη, χωρίς επιπλέον τίτλους ή πρόθεματα.
country String Όχι Κωδικός χώρας δύο χαρακτήρων (ISO 3166-1 alpha-2) για βελτίωση ακρίβειας. Παράδειγμα: TR για την Τουρκία.
askToAI Boolean Όχι Αν οριστεί ως true, το API θα ρωτήσει ένα AI μοντέλο αν το όνομα δεν βρεθεί στη βάση δεδομένων.
forceToGenderize Boolean Όχι Αν οριστεί ως true, το API θα προσπαθήσει να μαντέψει φύλο ακόμα και για είσοδοι που δεν μοιάζουν με πραγματικά ανθρώπινα ονόματα, όπως ψευδώνυμα ή φανταστικοί όροι (π.χ. sparkling unicorn).

Παραδείγματα Αιτήματος


Παράδειγμα cURL

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

<?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

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


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())

Παράδειγμα JSON απόκρισης

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

Πεδία Απόκρισης

Πεδίο Τύπος Περιγραφή
status Boolean Δείχνει αν το αίτημα ήταν επιτυχές.
used_credits Integer Αριθμός μονάδων που καταναλώθηκαν για αυτό το αίτημα.
remaining_credits Integer Υπόλοιπες μονάδες στον λογαριασμό σου μετά από αυτό το αίτημα.
expires Integer (timestamp) Ημερομηνία λήξης του πακέτου σε UNIX timestamp.
q String Το αρχικό ερώτημα εισόδου σου (το όνομα που στάλθηκε).
name String Το αναλυμένο ή εξαγόμενο όνομα.
gender Enum[String] Το προβλεπόμενο φύλο. Δυνατές τιμές: male, female ή null.
country String Ο κωδικός χώρας που λήφθηκε υπόψη κατά την πρόβλεψη.
total_names Integer Αριθμός δειγμάτων που χρησιμοποιήθηκαν για αυτήν την πρόβλεψη.
probability Integer Ποσοστό βεβαιότητας για την πρόβλεψη φύλου.
duration String Χρόνος επεξεργασίας του αιτήματος (π.χ. 4ms).
Προειδοποίηση: Βεβαιώσου ότι οι τιμές εισόδου, όπως τα ονόματα, δεν περιέχουν μη αναμενόμενους χαρακτήρες. Αν σκοπεύεις να χρησιμοποιήσεις ειδικούς χαρακτήρες ή κενά, φρόντισε για σωστή κωδικοποίηση JSON για να αποφύγεις σφάλματα.