Bu iki API arasında neler değişiyor?
GenderAPI.io ve Gender-API.com ayrı servislerdir. İkisi de isim ve e-posta sorgularını belgeliyor; ancak istek modelleri, belirsiz sonuç değerleri ve ücretlendirme kuralları farklıdır. Benzer ürün isimleri ve V2 etiketi, uç noktaların veya anahtarların birbiri yerine kullanılabileceği anlamına gelmez.
| Karar ölçütü | GenderAPI.io V2 | Gender-API.com | Kaynaklar |
|---|---|---|---|
| İsim ve e-posta girdileri | /api/v2/gender üzerinde type ve value ile isim, e-posta veya kullanıcı adı gönderilir. Tam ad gönderilmesi, ad ve soyadın eksiksiz ayrıştırılacağı anlamına gelmez. | V2 belgelerinde first_name, full_name ve email girdileri ile çıkarılan first_name ve last_name alanları yer alır. | [1][13][11] |
| İstek ve kimlik doğrulama | GenderAPI.io anahtarıyla Authorization: Bearer kullanılır. Basit GET örnekleri için URL üzerinden anahtar da desteklenir; uygulamalarda başlığı tercih edin. | Bearer kimlik doğrulamalı JSON POST kullanılır. Açıklama sayfaları ile OpenAPI’de farklı uç nokta biçimleri yer alır; aşağıdaki geçiş notuna bakın. | [2][12][14] |
| Ülke bağlamı | country isteğe bağlıdır. Seçilen veriyi anlamak için match.scope ve match.country alanlarına bakın. | İncelenen isim sorgusu belgesinde country, locale veya ip isteğe bağlıdır. | [3][12] |
| Güven puanı ve belirsiz sonuçlar | data.confidence: 0–1 veya null. confidence_kind, kayıt sayılarından hesaplanan oranı yapay zekâ puanından ayırır. Yapay zekâ sonuçlarında sample_count null olur. Belirsiz sonuçta data.result_status: unknown; data.gender ve data.confidence JSON null olur. data.reason alanını inceleyin. | result_found, unknown dahil gender, 0–1 aralığında probability ve details.samples alanları bulunur. Eşit örnek sayıları unknown sonucuna yol açabilir. | [3][12][14] |
| Toplu sorgular | Anahtarlı kullanımda en fazla 50, IP denemesinde 10 öğe. Her öğenin type, country ve options alanları ayrı olabilir. | Dizi girdileri belgelenmiştir. Kaynaklarda yayımlanan toplu sorgu sınırları farklıdır; seçtiğiniz uç noktanın sınırını doğrulayın. | [5][9][15] |
| Yapay zekâ ve kullanıcı adı seçenekleri | off, fallback ve always modları vardır. Tekli sorgularda varsayılan fallback, toplu sorgularda off olur. İsteğe bağlı forceToGenderize, önce veri tabanına, sonuç yoksa takma adları da değerlendiren yapay zekâya başvurur. | İncelenen V2 istek tablolarında eşdeğer yapay zekâ modu seçenekleri veya kullanıcı adına özel bir alan belgelenmemiştir. | [4][14] |
| Belirsiz sonuçların ücretlendirilmesi | Normal, başarıyla işlenen sorgular; belirsiz sonuç ve fallback yapay zekâ dahil 1 kredi kullanır. always modu 2 kredidir. forceToGenderize, veri tabanı sonucu bulunduğunda 1, yapay zekâ çalıştığında 2 kredi kullanır. | Ücretlendirme SSS’sine göre yalnız sonuç bulunan sorgular sayılır ve her isim ayrı hesaplanır. | [6][10] |
Entegrasyonu taşımadan önce
V2 açıklama sayfasında /v2/gender gösterilirken resmi OpenAPI, /v2/gender/by-first-name ve /by-email-address gibi yollar kullanıyor. Genel toplu sorgu SSS’sinde 100, Python istemcisi sayfasında 1.000 isim sınırı belirtiliyor. Bu farkları çözmek için uç noktalara sorgu gönderilmedi. İstemci oluşturmadan önce kullanacağınız uç noktanın güncel kurallarını doğrulayın.
GenderAPI.io V2’ye geçerken first_name/full_name/email girdilerini type ve value ile değiştirin. unknown metin kontrolü yerine data.result_status ve null değerlerini açıkça işleyin. meta.usage.charged_credits ve billing_status alanlarını okuyun; GenderAPI.io’da belirsiz bir sonuç da ücretlendirilebilir. Güven eşiklerini otomatik taşımak yerine yeniden değerlendirin.
Kullanacağınız iş akışını değerlendirin
İşleme izniniz olan, kullanımınızı temsil eden bir örneklem seçin. Orijinal girdileri, ön işlemeyi ve ülke bağlamını sabit tutun. İsim, e-posta ve kullanıcı adı sorgularını ayrı değerlendirin. Sağlayıcıyı, uç noktayı, tarihi, ayarları ve yapay zekâ kullanılıp kullanılmadığını kaydedin.
Yanıt kapsamını (yanıtlanan / uygun girdiler), yanıtlanan sonuçlar içindeki doğruluğu (doğru / yanıtlanan) ve tüm uygun girdiler içindeki doğru sonuç oranını (doğru / uygun girdiler) ayrı ölçün. Belirsiz sonuçları, hataları, maliyeti ve gecikmeyi ayrıca raporlayın. Güven eşiğini doğrulama verisiyle seçip ayrı tutulan bir test örnekleminde kontrol edin.
GenderAPI.io bu sayfada bağımsız, referans etiketli bir doğruluk ölçümü yayımlamamaktadır. Veri tabanı büyüklüğü, API sözleşmesi testleri veya tek bir sağlayıcının çalışması, sizin verinizde hangi servisin daha iyi çalışacağını göstermez. İsimden çıkarılan ilişki, kişinin cinsiyet kimliğini belirlemez.
Kaynaklar:[7]
Sık sorulan sorular
GenderAPI.io ve Gender-API.com aynı API mi?
Hayır. Bu sayfa iki ayrı servisi karşılaştırıyor. Bir anahtarı veya isteği kopyalamadan önce API adresinizdeki, dokümantasyondaki ve hesap panelinizdeki alan adını kontrol edin.
Geçiş yaptığımda yanıtlar ve kredi maliyeti aynı kalır mı?
Aynı kalacağı gösterilmiş değildir. Yanıt alanları, isim çıkarma işlemi, belirsiz değerler ve ücretlendirme kuralları farklıdır. Trafiği taşımadan önce yanıtı okuyan kodunuzu ve maliyet hesabınızı kullanımınızı temsil eden örneklerle test edin.
Kaynaklar ve inceleme tarihleri
Sağlayıcı seçmeden önce güncel koşulları ve API davranışını bağlantılardaki belgelerden doğrulayın.
- GenderAPI.io V2 istek parametrelerihttps://www.genderapi.io/tr/docs/v2/request-parametersİnceleme tarihi:
- GenderAPI.io V2 kimlik doğrulamahttps://www.genderapi.io/tr/docs/v2/authenticationİnceleme tarihi:
- GenderAPI.io V2 yanıt alanlarıhttps://www.genderapi.io/tr/docs/v2/responsesİnceleme tarihi:
- GenderAPI.io V2 yapay zekâ seçeneklerihttps://www.genderapi.io/tr/docs/v2/ai-optionsİnceleme tarihi:
- GenderAPI.io V2 toplu sorgularhttps://www.genderapi.io/tr/docs/v2/batchİnceleme tarihi:
- GenderAPI.io V2 kredi ve kullanımhttps://www.genderapi.io/tr/docs/v2/credits-and-usageİnceleme tarihi:
- GenderAPI.io doğruluk değerlendirme yöntemihttps://www.genderapi.io/tr/accuracy-methodologyİnceleme tarihi:
- GenderAPI.io fiyatlandırmahttps://www.genderapi.io/tr/priceİnceleme tarihi:
- Gender-API.com FAQ: Can I query multiple names in one request?https://gender-api.com/en/frequently-asked-questions/can-i-query-multiple-names-in-one-requestİnceleme tarihi:
- Gender-API.com FAQ: How do requests get counted?https://gender-api.com/en/frequently-asked-questions/how-do-requests-get-countedİnceleme tarihi:
- Gender-API.com v2: Query by email addresshttps://gender-api.com/en/api-docs/v2/query-by-email-addressİnceleme tarihi:
- Gender-API.com v2: Query by first namehttps://gender-api.com/en/api-docs/v2/query-by-first-nameİnceleme tarihi:
- Gender-API.com v2: Query by full namehttps://gender-api.com/en/api-docs/v2/query-by-full-nameİnceleme tarihi:
- Gender-API.com official OpenAPI descriptionhttps://gender-api.com/openapi/openapi.ymlİnceleme tarihi:
- Gender-API.com Python code exampleshttps://gender-api.com/en/code-examples/pythonİnceleme tarihi: