⚡ 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.

İsimle sorgulama yapın

Bir isim tarafından cinsiyeti sorgulamanın en kolay yolu budur. Her yanıt JSON kodlamalıdır:

POST https://gender-api.com/v2/gender

info Gerekli Talepler: 1

http Headers

Content-Type: application/json

Authorization: Bearer <Yetkilendirme belirteciniz>

link

data_object JSON Payload

Alan	Tür	Gerekli	Açıklama
`first_name`	string	Evet	Sorgulamak için isim
`country`	string	Hayır	ISO 3166 ALPHA-2 Ülke Kodu link
`locale`	string	Hayır	Tarayıcı Dil Ayarı
`ip`	string	Hayır	Geçerli IPv4 veya IPv6 adresi
`id`	string	Hayır	Maksimum 50 karakter. Bu kimliği herhangi bir alfanumerik değere ayarlayabilirsiniz. Örnek olarak, kimliği veritabanınızdaki veri kümesinin iç kimliği olarak ayarlayabilirsiniz. Asenkron bir ortamda, bu size önceki bir isteği yanıta daha iyi bağlamanıza yardımcı olabilir

code Örnek İstekler

arrow_forward Sadece ad ile sorgu yapma

play_arrow Codepen.io’da Canlı Dene

{
    "first_name": "Sandra"
}

arrow_forward Ad ve ülke kodu ile sorgu yapma

play_arrow Codepen.io’da Canlı Dene

{
    "first_name": "Sandra",
    "country": "US"
}

arrow_forward Ad ve tarayıcı yereli ile sorgu yapma

play_arrow Codepen.io’da Canlı Dene

{
    "first_name": "Sandra",
    "locale": "en_US"
}

arrow_forward Ad ve bölge belirlemek için IP adresi kullanarak sorgu yapma

play_arrow Codepen.io’da Canlı Dene

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

arrow_forward Birden fazla adı tek bir istekte sorgula

play_arrow Codepen.io’da Canlı Dene

[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle Yanıt

{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

list 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.first_name_sanitized`	string	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
`first_name`	string	Cinsiyetlendirme için kullandığımız ilk 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