⚡ Birleştirilmiş API v2.0
GELİŞMİŞ
API DOKÜMANTASYONU
Yüksek istek hacmine sahip ileri düzey kullanıcılar için tasarlanmış yüksek performanslı birleştirilmiş API’mizi deneyimle. Tek bir istekte birden fazla ismi sorgula ve şimşek hızında yanıt al.
Tam isme göre sorgu - İSİM VE SOYİSİM AYRIĞI
Eğer sayfanızda ad ve soyadı birleştirilmiş bir alan kullanıyorsanız, bu API'yi kullanarak parçaları çıkarabilirsiniz:
POST https://gender-api.com/v2/gender
Gerekli Talepler: 1
| Headers |
Content-Type: application/json
Authorization: Bearer <Yetkilendirme belirteciniz>
|
||||||||||||||||||||||||
| JSON Payload |
|
Örnek İstekler
Sadece tam adla sorgula
Codepen.io’da Canlı Dene
{
"full_name": "Theresa Miller"
}
Tam ad ve ülke kodu ile sorgula
Codepen.io’da Canlı Dene
{
"full_name": "Theresa Miller",
"country": "US"
}
Tam ad ve tarayıcı dil koduyla sorgula
Codepen.io’da Canlı Dene
{
"full_name": "Thomas Johnson",
"locale": "en_US"
}
Tam ada göre sorgula ve konumlandırma için IP adresi kullan
Codepen.io’da Canlı Dene
{
"full_name": "Markus Stefan NonExistingLastName",
"ip": "54.201.16.177"
}
Birden fazla adı tek bir istekte sorgula
Codepen.io’da Canlı Dene
[
{
"full_name": "Theresa Miller"
},
{
"full_name": "Thomas Johnson",
"country": "US"
}
]
Yanıt
{
"input": {
"full_name": "Theresa Miller"
},
"details": {
"credits_used": 1,
"duration": "33ms",
"samples": 8961,
"country": null,
"first_name_sanitized": "theresa"
},
"result_found": true,
"last_name": "Miller",
"first_name": "Theresa",
"probability": 0.98,
"gender": "female"
}
Yanıt Alanları
| Alan | Tür | Açıklama |
|---|---|---|
input |
object | Gönderilen veri yükü |
details.credits_used |
int | Bu sorgu için kullanılan istek sayısı |
details.samples |
int | İstediğinizle eşleşen veritabanımızdaki kayıt sayısı |
details.country |
string | Bulduğumuz ülke |
details.full_name_sanitized |
int | Normalizasyon işlemimizi uyguladıktan sonra isim |
details.duration |
string | Sunucunun isteği işlemesi için gereken zaman |
result_found |
bool | Belirtilen isim için bir cinsiyet sorgulayabildiysek doğru |
full_name |
string | Cinsiyetlendirme için kullandığımız tam isim |
probability |
float | Bu (0 ile 1 arasındaki) değer, veritabanımızın güvenilirliğini belirler. 1 değeri, cinsiyet talebinize yönelik sonuçların %100 doğru olduğu anlamına gelir. |
gender |
string | Olası değerler: erkek, kadın, bilinmiyor |