Bu iki API arasında neler değişiyor?
Namsor; ad/soyad, tam ad ve ülke bağlamı için ayrı cinsiyet sorguları belgeliyor. GenderAPI.io V2; isim, e-posta ve kullanıcı adı için type ve value kullanıyor. Bu sayfanın kapsamı cinsiyet sorgusu entegrasyonudur; Namsor’un diğer isim analizi ürünleri karşılaştırılmıyor.
| Karar ölçütü | GenderAPI.io V2 | Namsor | Kaynaklar |
|---|---|---|---|
| İsim girdileri | /api/v2/gender üzerinde type ve value ile isim, e-posta veya kullanıcı adı gönderilir. | firstName ve isteğe bağlı lastName; tam ad yollarında ayrıştırılmamış name kullanılır. firstName takma adları da kabul eder. | [1][10] |
| 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. | Namsor anahtarı, X-API-KEY başlığında gönderilir. | [2][11] |
| Ülke ve toplu sorgular | Anahtarlı kullanımda en fazla 50, IP denemesinde 10 öğe. Her öğenin type, country ve options alanları ayrı olabilir. Her öğede country isteğe bağlıdır. | genderBatch / genderFullBatch ve countryIso2 içeren Geo sürümleri; en fazla 100 isim. | [5][10] |
| Güven puanları | 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. | likelyGender, probabilityCalibrated (0–1), normalize edilmemiş score ve genderScale (−1 erkek, +1 kadın). | [3][10] |
| Belirsiz sonuçlar | data.result_status: unknown; data.gender ve data.confidence JSON null olur. data.reason alanını inceleyin. | İncelenen gender değer listesinde female ve male bulunur. Bu kaynaklar genel bir JSON-null belirsiz sonuç kuralı tanımlamıyor. | [3][9] |
| Yapay zekâ yönlendirmesi | 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 istek tablolarında off/fallback/always eşdeğeri bir seçenek belgelenmemiştir. | [4][10] |
| Kullanım hesabı | 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. | Fiyat sayfasında standart cinsiyet işlemi 1 kredidir. Diğer özelliklerin ve plan aşımının maliyetleri değişebilir. | [6][12] |
Entegrasyonu taşımadan önce
GenderAPI.io’ya geçerken X-API-KEY yerine Authorization: Bearer ve GenderAPI.io anahtarı kullanın. İsmi type: name ve value alanlarına, countryIso2 değerini country alanına eşleyin. personalNames yerine items gönderin; grupları V2 sınırına bölün. Öğe kimliklerini koruyup öğe hatalarını işleyin.
score veya genderScale değerini confidence olarak kullanmayın. probabilityCalibrated ile GenderAPI.io’nun 0–1 puanı için bile ortak kabul eşiğini test etmeden taşımayın. API’nin belirsiz sonucu ile düşük puanı kullanmama kararınızı ayrı kaydedin.
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
Namsor takma adları destekliyor mu?
Evet. firstName belgesi takma adları açıkça kapsıyor. Ancak bu, gerçek bir isim bulunmadan da takma addan ilişki çıkarmayı deneyen GenderAPI.io forceToGenderize ile aynı davranış değildir.
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:
- Namsor API enumeratorshttps://namsor.app/api-enumerators/İnceleme tarihi:
- Namsor Gender API: Predict gender from first or full nameshttps://namsor.app/api-documentation/gender-api/İnceleme tarihi:
- Namsor API documentation introductionhttps://namsor.app/api-documentation/introduction/İnceleme tarihi:
- Namsor prices and feature credit costshttps://namsor.app/prices/İnceleme tarihi: