API Belgeleri Birleşik API v2.0

API v1.0

Ayrıca, entegrasyonu daha kolay olan endpointlerimizle başka bir API sürümü de sunuyoruz. API'lerin uygulanmasında yeniyseniz, v1.0 endpointimize geçebilirsiniz.

İsimle sorgulama yapın

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

Post
Gerekli Talepler: 1
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <Yetkilendirme belirteciniz>
link
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

Örnekler

Sadece ad ile sorgu yapma
{"first_name":"Sandra"}
Ad ve ülke kodu ile sorgu yapma
{"first_name":"Sandra","country":"US"}
Ad ve tarayıcı yereli ile sorgu yapma
{"first_name":"Sandra","locale":"en_US"}
Ad ve bölge belirlemek için IP adresi kullanarak sorgu yapma
{"first_name":"Sandra","ip":"54.201.16.177"}
Birden fazla adı tek bir istekte sorgula
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
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"
}
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
Bu ürün, MaxMind tarafından oluşturulan GeoLite2 verilerini içerir, mevcuttur http://www.maxmind.com.
Sohbet