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.

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.

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.

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.

01

Sonuçlar, olasılık ve sorumluluk kullanımı

02

Veri kaynakları, gizlilik ve uyum

03

API işlemleri, hatalar ve fatura

GenderAPI isteklerini nasıl doğrulayabilirim?

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.