İsimden Cinsiyet Bulma – Tekli İstek
İsimden Cinsiyet Bulma uç noktası, tek bir ismin cinsiyetini belirlemenizi sağlar. Tüm parametreler POST isteği ile JSON formatında gönderilir. Authorization başlığında Bearer token yöntemiyle kimlik doğrulaması yapmanız gerekir.
İstek URL’si
POST https://api.genderapi.io/api
Gerekli HTTP Başlıkları
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
İstek Gövdesi Parametreleri
Parametre | Tip | Gerekli | Açıklama |
---|---|---|---|
name | String | Evet | Analiz etmek istediğiniz ilk isim. Sadece bir kelime olmalı, ek unvan veya ön ek içermemelidir. |
country | String | Hayır |
Tahmin doğruluğunu artırmak için iki harfli ülke kodu (ISO 3166-1 alpha-2).
Örnek: Türkiye için TR .
|
askToAI | Boolean | Hayır |
true olarak ayarlanırsa, isim veritabanında bulunamazsa API bir yapay zekadan tahmin istemeye çalışır.
|
forceToGenderize | Boolean | Hayır |
true olarak ayarlanırsa, API tipik insan isimleri olmayan girdiler için bile cinsiyet tahmini yapmaya çalışır.
(ör: takma adlar veya hayali isimler – sparkling unicorn gibi).
|
İstek Örnekleri
cURL Örneği
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 Örneği
<?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 Örneği
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 Örneği
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 Yanıt Örneği
{
"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"
}
Yanıt Alanları
Alan | Tip | Açıklama |
---|---|---|
status | Boolean | İsteğin başarılı olup olmadığını gösterir. |
used_credits | Integer | Bu istek için harcanan kredi sayısı. |
remaining_credits | Integer | İstekten sonra hesabınızda kalan kredi sayısı. |
expires | Integer (timestamp) | Paketinizin UNIX zaman damgası (timestamp) olarak bitiş tarihi. |
q | String | Gönderdiğiniz isim (sorgu). |
name | String | Analiz edilen veya çıkarılan isim. |
gender | Enum[String] | Tahmin edilen cinsiyet. Olası değerler: male , female veya null . |
country | String | Tahmin sırasında dikkate alınan ülke kodu. |
total_names | Integer | Bu tahmin için kullanılan örnek sayısı. |
probability | Integer | Cinsiyet tahmininin yüzde olarak güven oranı. |
duration | String | İsteğin işlenme süresi (ör: 4ms ). |
Uyarı:
İsim gibi giriş değerlerinin beklenmeyen karakterler içermediğinden emin olun.
Eğer özel karakterler veya boşluklar kullanacaksanız, hataları önlemek için uygun JSON kodlaması yapın.