GenderAPI yardım merkezi
Sık sorulan sorular
İsimden cinsiyet tahmini, API sorguları, yapay zekâ desteği, krediler, veri gizliliği ve hesap yönetimi hakkında açık yanıtlar.
Sonuçlar ve doğruluk
GenderAPI sonuçlarını doğru yorumlama
Ülke bağlamı, probability skoru ve isim tabanlı tahminin nasıl değerlendirilmesi gerektiği.
Bir isim farklı ülkelerde farklı biçimde kullanılıyorsa ne olur?
İlgili ülke biliniyorsa ISO ülke kodunu gönderin. GenderAPI ismi değerlendirirken bölgesel bağlamı kullanır; bu nedenle dönen cinsiyet sinyali ve probability ülkeden ülkeye değişebilir.
GenderAPI sonucu bir kişinin cinsiyetini kesin olarak belirler mi?
Hayır. GenderAPI, isim verilerinden hareketle olasılıksal bir tahmin döndürür. Bu sonuç kişinin kendi beyan ettiği cinsiyet değildir, doğrulanmış kişisel bilgi olarak değerlendirilmemeli ve yüksek etkili kararlarda kullanılmamalıdır.
Probability alanını nasıl kullanmalıyım?
Probability değerini kendi inceleme eşikleriniz için bir güven sinyali olarak kullanın. Bilinmeyen sonucu koruyun; düşük güvenli veya belirsiz kayıtları zorla bir kategoriye atamayın.
Hangi ülkeler ve yazı sistemleri destekleniyor?
GenderAPI; Çince, Hint dilleri, Japonca ve Arapça yazılar dahil Unicode girişleri ve dünya çapındaki isim verilerini destekler. Kapsam isme, ülkeye ve mevcut kanıta göre değişir; kendi veri kümenizi temsil eden kayıtlarla test yapın.
Çince isimleri deneyin →Hint isimlerini deneyin →Japonca isimleri deneyin →Arapça isimleri deneyin →
API ve yapay zekâ
Sorgular, endpoint'ler ve AI desteği
Doğru endpoint'i seçme ve sorgu davranışını anlama.
Tek sorguda birden fazla isim analiz edebilir miyim?
Evet. Çoklu isim endpoint'i ile tek istekte 100 isme kadar işlem yapabilirsiniz. Her kayıt kendi sonucunu ve kredi kullanımını oluşturur.
E-posta adresinden cinsiyet tahmini nasıl çalışır?
E-posta endpoint'i kişisel adresin @ işaretinden önceki bölümünden olası bir isim çıkarır ve bu ismi değerlendirir. info@ veya support@ gibi görev adresleri çoğunlukla kullanılabilir bir kişisel isim sinyali içermez.
Kullanıcı adından cinsiyet tahmini nasıl çalışır?
Kullanıcı adı endpoint'i kullanıcı adı, takma ad veya görünen ad içinde olası bir isim arar ve ardından bu ismi değerlendirir. Marka niteliğindeki veya soyut kullanıcı adları sonuç vermeyebilir.
Kullanıcı adı analizini deneyin →Kullanıcı adı API dokümantasyonu →
askToAI parametresi ne işe yarar?
askToAI true olduğunda veritabanında gönderilen veya çıkarılan isim için sonuç bulunamazsa AI desteği kullanılabilir. Bu seçenek sonuç garantisi vermez ve zorla tahmin üretmek anlamına gelmez.
İstemci kütüphaneleri ve kod örnekleri var mı?
Evet. İstemci kütüphaneleri sayfasında desteklenen SDK ve doğrulama seçenekleri, her endpoint rehberinde ise güncel istek örnekleri bulunur.
API kredileri nasıl kullanılır?
Kredi tüketimi API yanıtında bildirilir. Çoklu sorgularda işlenen her sonuç için kredi kullanılır. Kalan kredileri ve paket bilgisini kullanım endpoint'i üzerinden kontrol edebilirsiniz.
Gizlilik ve dosyalar
Verilerin ve yüklenen dosyaların işlenmesi
GenderAPI'nin sorgu işleme, saklama ve silme kuralları.
Sonuç bulunan GenderAPI sorguları kaydediliyor mu?
Hayır. Sonuç bulunan GenderAPI sorguları kaydedilmez. Yalnızca cinsiyeti bulunamayan ve e-posta olmayan bir sorgu GenderAPI'yi geliştirmek amacıyla saklanabilir.
E-posta sorgularındaki girişler kaydediliyor mu?
Hayır. Hizmet sonuç üretemese bile e-posta sorgusu girişleri hiçbir şekilde kaydedilmez.
Yüklenen Excel veya CSV dosyaları saklanıyor mu?
Excel ve CSV dosyaları en fazla beş gün tutulur ve ardından silinir. Kullanıcı sonuçları dışa aktardıktan sonra otomatik silmeyi beklemeden dosyayı hemen silmeyi seçebilir.
Sorgular veya yüklenen dosyalar üçüncü taraflarla paylaşılıyor mu?
Hayır. GenderAPI sorgu girişlerini veya yüklenen dosya verilerini üçüncü taraflarla paylaşmaz.
Gizlilik Politikası →GDPR bilgileri →Kaliforniya gizlilik bilgileri →
Hesap ve destek
Hesap, faturalandırma ve teknik yardım
Kimlik bilgilerini, aboneliği ve destek taleplerini yönetme.
API anahtarımı nasıl korumalıyım?
API anahtarlarını sunucunuzda saklayın ve kimliği doğrulanmış istekleri güvenilir backend kodundan gönderin. Production anahtarını herkese açık istemci JavaScript'inde göstermeyin veya kaynak kontrolüne eklemeyin.
Aboneliğimi nereden yönetebilir veya iptal edebilirim?
GenderAPI uygulamasında oturum açarak ilgili API anahtarına bağlı aboneliği yönetin. Panel kontrolleri değişebileceği için eski menü tarifleri yerine güncel hesap arayüzünü kullanın.
Fatura bilgilerimi nereden güncelleyebilirim?
Fatura ve ödeme ayarları, oturum açılan GenderAPI uygulamasında ilgili API anahtarı veya abonelik üzerinden yönetilir.
Hatalı sonucu veya entegrasyon sorununu nasıl bildirebilirim?
İstek ayrıntılarını, dönen yanıtı ve sorunu yeniden üreten en küçük örneği destek ekibine gönderin. Production API anahtarını veya hassas kişisel verileri eklemeyin.
Teknik bilgi kaynakları
Uygulama ve sorumluluk rehberleri
Odaklanan cevaplar, ayrıntılı canonical sayfalar ve makine okuyabilen Markdown sürümleri ile.
Sonuçlar, olasılık ve sorumluluk kullanımı
Bir ismin farklı nesil gruplarında kullanılıp kullanılmadığı ya da mevcut kanıtın bir kategoriyi kesin olarak desteklememesi durumunda bir arama belirsiz olabilir. Çözülemez bir yanıt için cinsiyet değeri doğrudan "null" metin dizisi olur, JSON null değildir. Bu değeri bilinmeyen olarak ele alınız, sonucu ve bağlamını koruyun ve hiçbir zaman çözülemez bir sonucu ikili bir değer olarak zorla.
Tam cevabı oku →GenderAPI doğruluk oranı nasıl ölçülür?Bir savunulabilir doğruluk sonucu için tarihli test popülasyonu, örnek alma yöntemi, eğitim-test ayrımı, sınıflandırma eşiği, bilinmeyen kapsam ve ülke ve yazım sistemi bazlı sonuçlar gereklidir. Olasılık kalibrasyonu ve örnek sayıları da raporlanmalıdır. GenderAPI burada kanıt olmadan bir yüzde yayılmaz; dönen olasılığı güvenilirlik sinyali olarak kullanın ve temsil eden verilerinizde performansı doğrulayın.
Tam cevabı oku →Veri kaynakları, gizlilik ve uyum
Bir faydalı kaynak açıklaması, kaynak kategorilerini, seçim kriterlerini, coğrafi ve metin sınırlarını, kalite kontrolünü, lisans kısıtlamalarını ve kaldırma süreçlerini belirtir ancak korumalı kayıtları ortaya çıkarır. Mevcut açıklanan sınırlar için standart GenderAPI kaynak açıklamasını kullanın; özel veri setlerinin içeriği ya da veri tabanı ölçekli verileri tahmin etmeyin, bunlar açıkça belgelenmemişse.
Tam cevabı oku →İsim verileri ne sıklıkla güncellenir?GenderAPI, her alt kaynak veya işleme kuralı için sabit bir genel güncelleme sıklığı yayımlamaz. Güncelleme zamanı önemliyse, resmi kaynaklarda belirtilen inceleme tarihi ve kapsamı kullanın ve belirli veri seti veya iş akışıyla ilgili destek ekibine sorun. Tüm kayıtların aynı zamanda yeniden oluşturulduğunu varsaymamak önemlidir.
Tam cevabı oku →GenderAPI, GDPR ve DPA gerekliliklerini nasıl destekler?Mevcut işleyiş rolleri, haklar, iletişim kanalları, saklama sınırları ve koruyucu önlemlerle ilgili detaylı açıklamaları, resmi GDPR ve Gizlilik Politikası sayfalarını inceleyin. DPA, alt işlemcisi, veri aktarımı veya veri sahibi talebi, sizin kurumunuzun etkilenmesi durumunda GenderAPI'ye başvurun ve uygulanan anlaşmanın ve mevcut politikayı güvenerek uygulayın, genel bir SSS özetini değil.
Tam cevabı oku →API işlemleri, hatalar ve fatura
Güvenilir sunucu kodundan POST istekleri gönderin ve API anahtarınızı Authorization başlığına Bearer şemasıyla ekleyin. Anahtarın ortam değişkeni veya gizli yöneticide olmasına dikkat edin, JSON içerik türünü ayarlayın ve kimlik bilgisi tarayıcı kodunda hiçbir zaman gösterilmemelidir. Üretim kullanımından önce doğrulama sayfasını ve mevcut OpenAPI sözleşmesini inceleyin.
Tam cevabı oku →Müşteriler, hız sınırları ve yeniden denecekleri nasıl yönetmeli?Mevcut sözleşmede bir saniye başına istek sınırı belirtilmemişse, bu sınırı kendi yaratmamalısınız. Sadece geçici taşıma veya sunucu hatası için sınırlı yeniden denebilmelidir. Üst sınırı ve jitter ile eksponansiyel geri dönüş kullanın ve küçük bir yapılandırılmış denecek sayısı sonrasında durun. Kimlik doğrulama, geçersiz giriş, erişim, kota ve sona erme hatası, yeniden denecek yerine düzeltmelidir.
Tam cevabı oku →GenderAPI hata kodlarını nasıl yönetmeliyim?HTTP sonuçunu ve JSON durum alanını kontrol etmelisiniz çünkü canlı doğrulama ve kimlik doğrulama hataları HTTP 200 yanıtlarında döner. Durum false olduğunda, belgelenmiş errno'ya göre dalış yapmalısınız ve mesajın metnini analiz etmeyin. Göndermeden önce girişleri doğrulayın, loglara kimlik bilgilerini ve kişisel verileri gizleyin ve kalıcı hataları düzeltme eylemine değil, yeniden deneme eylemine bağlamadan düzeltin.
Tam cevabı oku →Kalan kredileri ve oturum miktarını nasıl kontrol edebilirim?Güvenilir sunucu tarafı izleme kodu içinde belirtilen anahtarın belirtilen anahtar sorgu parametresi ile 'remaining-usage' uç noktasını çağırın; canlı doğrulama sonucunda bu işlem için 'Bearer' kimlik doğrulaması reddedildi. Bu URL'yi tarayıcı kodu, loglar, analizler veya ekran görüntülerinde hiçbir şekilde göstermeyin. Kalan ve expiresAt'ı operasyonel sinyaller olarak değerlendirin, tam istek URL'sini gizleyin ve giriş yapmış hesabınızda imzalı sözleşmeleri doğrulayın.
Tam cevabı oku →API sürümleri ve kesinti değişiklikleri nasıl yönetilir?Standart OpenAPI belgesine dayanarak geliştirin ve entegrasyonunuz tarafından kullanılan sözleşme sürümünü kaydedin. Onaylanan yaşam döngüsü politikası, kullanım ölçümü, müşteri bilgilendirme ve geçiş dönemi tamamlanana kadar eski davranışları korur. Yükseltmeden önce şemaları ve örnekleri karşılaştırın, başarılı ve hata yanıtları için sözleşme testlerini çalıştırın ve geri alım yolu bulundurun. Yayın, ortak release kapısı tarafından kontrol edilir.
Tam cevabı oku →CinsiyetAPI hizmet durumunu ve sürekliliğini nerede kontrol edebilirim?Bir sahibi onaylayan durum veya izleme kaynagı belirlenince onu kullanın. Bir ölçüme, izlenen bileşenlere, dışlamalara ve tarihli kanıt olmadan kullanılabilirlik yüzdesini tekrarlamayın. Kullanım entegrasyonunuz için istek başarı durumu, gecikme ve hata kategorilerini bağımsız olarak izleyin ve hizmet olayını kimlik doğrulama, kota, geçersiz giriş veya yerel ağ hatası gibi durumlardan ayırt edin.
Tam cevabı oku →Hâlâ yardıma mı ihtiyacınız var?
Yeniden üretilebilir bir örnek gönderin
Endpoint'i, istek parametrelerini ve dönen hatayı ekleyin; production API anahtarınızı veya hassas kişisel verileri paylaşmayın.