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.
API v1.0'ı Görüntüle

OpenAPI

Swagger'da API belgelerimizi görüntüleyin

Postman

API tanımımızı Postman'e aktarın
İsme Göre Sorgulama
Tam Adına Göre Sorgulama
E-posta Adresine Göre Sorgulama
Köken Ülkesi Al
İstatistikleri Al
Hata Kodları

İ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
play_arrow Codepen.io ile canlı test yapın 
{"first_name":"Sandra"}
Ad ve ülke kodu ile sorgu yapma
play_arrow Codepen.io ile canlı test yapın 
{"first_name":"Sandra","country":"US"}
Ad ve tarayıcı yereli ile sorgu yapma
play_arrow Codepen.io ile canlı test yapın 
{"first_name":"Sandra","locale":"en_US"}
Ad ve bölge belirlemek için IP adresi kullanarak sorgu yapma
play_arrow Codepen.io ile canlı test yapın 
{"first_name":"Sandra","ip":"54.201.16.177"}
Birden fazla adı tek bir istekte sorgula
play_arrow Codepen.io ile canlı test yapın 
[{"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