Temel kullanım
İlk Gender API sorgunuzu gönderin
Tek bir değer göndererek tahmin edilen cinsiyet, probability, ülke ve kredi kullanım bilgilerini alın. Elinizdeki veriye göre isim, e-posta veya kullanıcı adı endpoint'ini seçin.
API anahtarınızı key sorgu parametresiyle ekleyin. Üretim anahtarlarını sunucunuzda saklayın; tarayıcı kodunda veya herkese açık depoda paylaşmayın.
İsimden cinsiyet
Ad veya ad soyad sorgusu
Girdiniz bir ad ya da tam ad olduğunda temel endpoint'i kullanın.
https://api.genderapi.io/apicurl "https://api.genderapi.io/api?name=Alice&key=YOUR_API_KEY"İsteğe bağlı parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
country | string | TR veya US gibi iki harfli ülke kodu. |
askToAI | boolean | true olduğunda isim veritabanında bulunamazsa yapay zekâ desteğini devreye alır. |
forceToGenderize | boolean | İnsan adına benzemeyen sıra dışı girdiler için tahmin üretmeyi dener. |
E-postadan cinsiyet
E-posta adresi sorgusu
E-posta endpoint'i cinsiyet tahmininden önce adresteki olası adı otomatik olarak çıkarır.
https://api.genderapi.io/api/emailcurl "https://api.genderapi.io/api/email?email=alice.smith%40example.com&country=TR&askToAI=true&key=YOUR_API_KEY"forceToGenderize, isim dahili olarak çıkarıldığı için bu endpoint'te kullanılamaz.Kullanıcı adından cinsiyet
Sosyal medya kullanıcı adı
İsim içerebilecek kullanıcı adları, rumuzlar ve nickname değerleri için bu endpoint'i kullanın.
https://api.genderapi.io/api/usernamecurl "https://api.genderapi.io/api/username?username=sparkling_unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"JSON yanıtı
GenderAPI yanıt alanlarını anlayın
Üç endpoint de aynı temel yanıt yapısını kullanır.
{
"status": true,
"used_credits": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "Alice",
"name": "alice",
"gender": "female",
"country": "US",
"total_names": 325,
"probability": 98,
"duration": "4ms"
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
status | boolean | Sorgunun başarıyla tamamlanıp tamamlanmadığı. |
used_credits | integer | Bu sorguda kullanılan kredi miktarı. |
remaining_credits | integer | Sorgudan sonra kalan kredi miktarı. |
expires | integer | Paket sona erme zamanının UNIX timestamp değeri. |
q | string | Gönderilen özgün isim, e-posta veya kullanıcı adı. |
name | string | Normalize edilen veya girdiden çıkarılan ad. |
gender | string | null | Tahmin edilen cinsiyet: male, female veya null. |
country | string | En olası ISO 3166-1 alpha-2 ülke kodu. |
total_names | integer | Tahminde kullanılan isim kaydı sayısı. |
probability | integer | Yüzde olarak tahmin olasılığı. |
duration | string | Sunucudaki sorgu işleme süresi. |
Girdi değerlerini her zaman URL-encode edin
Boşluklar ve özel karakterler HTTP istemciniz tarafından kodlanmalıdır. Örneğin ham boşluk yerine sparkling%20unicorn kullanın.
Entegrasyona devam edin