GenderAPI yardım merkezi
Sık sorulan sorular
API V2, ücretsiz erişim, yapay zekâ seçenekleri, kredi maliyetleri ve gizlilik hakkında yanıtlar. Mevcut V1 entegrasyonunuzu sürdürüyor musunuz? V1 dokümantasyonunu okuyun.
Sonuçlar ve güven skoru
Tahmini ve sınırlarını anlayın
API V2'de ülke bağlamı, güven skoru ve bilinmeyen sonuçlar.
GenderAPI sonucu bir kişinin cinsiyetini kesin olarak belirler mi?
Hayır. GenderAPI, isimle ilişkili verilerden veya ilgili seçenek etkinse takma adın verdiği ipuçlarından cinsiyet tahmini üretir. Tahmin, doğrulanmış kişisel bilgi değildir. Belirsizliği koruyun, kişinin kendi kimlik beyanını esas alın ve önemli sonuçlar doğurabilecek kararları yalnızca bu tahmine dayandırmayın.
Ülke bilgisi sonucu nasıl etkiler?
İsteğe bağlı ISO ülke kodu, sorguya bölgesel bağlam sağlar. Ülkeyi yalnızca ilgili ve biliniyorsa büyük harflerle gönderin. Aynı isim farklı bölgelerde farklı biçimde kullanılabilir. Yanıttaki country değeri isimle ilişkili ülkeyi gösterir; kişinin vatandaşlığını veya yaşadığı yeri kanıtlamaz.
V2'de confidence skoru ne anlama gelir?
confidence, 0 ile 1 arasında bir değerdir; skor mevcut değilse null döner. Bu alanı confidence_kind ile birlikte okuyun: observed_frequency, veri kümesinde baskın kategorinin sayısının toplam sayıya oranıdır; model_reported ise yapay zekânın bildirdiği skordur. Bunlar bir kişinin cinsiyetine ilişkin kalibre edilmiş olasılıklar veya ürünün ölçülmüş doğruluk oranı değildir. İnceleme eşiklerini kendi kullanımınızı temsil eden verilerle belirleyin.
gender: null ne demektir ve kredi düşülür mü?
Başarılı bir V2 yanıtında gender: null, mevcut kanıtla cinsiyet belirlenemediği anlamına gelir. Değer, "null" metni değil, JSON null değeridir. Başarılı ancak sonucu bilinmeyen sorgular da seçilen tarifeye göre ücretlendirilir. Bu sonucu bilinmeyen olarak koruyun; istek veya sağlayıcı hatası ayrı bir hata durumudur.
Farklı yazı sistemlerindeki isimleri gönderebilir miyim?
Evet. Unicode isimleri özgün karakterleri ve anlam taşıyan aksanlarıyla gönderin. Kapsam ve güven skoru isme, bölgeye ve mevcut kanıta göre değişir. Uygulamanızın hizmet verdiği ülkeleri ve yazı sistemlerini temsil eden bir örneklemle test yapın.
API ve yapay zekâ
Sorgu türünü ve yapay zekâ seçeneğini belirleyin
V2 sorgu türleri, toplu istekler, yapay zekâ davranışı ve kullanım sınırları.
İsimleri, e-postaları ve kullanıcı adlarını aynı toplu istekte sorgulayabilir miyim?
Evet. POST /api/v2/gender/batch, API anahtarıyla en fazla 50, IP denemesinde en fazla 10 öğe kabul eder. Her öğenin kendi type, value, isteğe bağlı country ve yapay zekâ ayarları vardır. Öğelerde yapay zekâ varsayılan olarak kapalıdır. Her sonucu ayrı kontrol edin: bazı öğeler hata verse bile toplu yanıt HTTP 200 olabilir. Bilinmeyen sonuçlar dahil, başarıyla tamamlanan her öğe için kredi düşülür.
E-posta adresinden sorgu nasıl çalışır?
Geçerli bir adresle type: email kullanın. API, @ işaretinden önceki bölümde kullanılabilir bir isim ipucu arar; alan adı kişinin kimliğini veya ülkesini belirlemez. Ortak kullanılan posta kutuları ve isim içermeyen adresler bilinmeyen sonuç verebilir. Tekli istekte veri kümesinden sonuç alınamazsa varsayılan olarak yapay zekâya başvurulur.
Kullanıcı adından sorgu nasıl çalışır?
type: username kullanın. Standart sorgu, kullanıcı adında veya görünen adda tanınabilir bir kişi adı arar. Soyut takma adlar bilinmeyen sonuç verebilir. Veri kümesinde sonuç bulunamadığında takma addaki ipuçlarını da değerlendiren yapay zekâ kullanmak için forceToGenderize seçeneğini etkinleştirin. Bu seçenek, gerçek bir kişi adı çıkarılmadan da cinsiyet tahmini üretebilir.
V2 ne zaman yapay zekâ kullanır?
Tekli isteklerde options.ai_mode varsayılanı fallback'tir: önce veri kümesine bakılır, cinsiyet belirlenemezse yapay zekâ kullanılır ve toplam 1 kredi düşülür. off yalnızca veri kümesini kullanır ve 1 kredidir; always veri kümesini atlayıp doğrudan yapay zekâ kullanır ve 2 kredidir. Toplu istekte her öğenin varsayılanı off'tur; yapay zekâ öğe bazında açılabilir. Bu modların hiçbiri null dışında bir sonuç garantisi vermez.
forceToGenderize ne işe yarar?
Bu isteğe bağlı seçenek isim, e-posta ve kullanıcı adı sorgularında, toplu isteğin her öğesi için de kullanılabilir. Veri kümesinde cinsiyet bulunursa 1 kredi düşülür. Bulunamazsa takma adları da değerlendiren yapay zekâ kullanılır; başarılı ancak sonucu bilinmeyen yanıtlar dahil toplam 2 kredi düşülür. Gerçek bir kişi adı bulunması gerekmez. ai_mode alanını göndermeyin veya fallback kullanın; bu seçeneği off ya da always ile birleştirmek 422 hatası verir.
V2'de krediler nasıl düşülür?
İşlemin net kredi maliyeti için meta.usage.charged_credits, ücretlendirmenin kesinleşme durumu için billing_status alanını okuyun. Standart veri kümesi ve fallback sorgularında başarıyla tamamlanan her öğe 1 kredidir; always ve takma adları değerlendiren yapay zekâ sorguları 2 kredidir. Geçersiz numara sonuçları dahil tamamlanan telefon kontrolleri 1 kredidir. İşlemin başlaması için pozitif bakiye yeterlidir; son kesinti bakiyeyi eksiye düşürebilir. Başarısız tahminlerin kredisi iade edilir; ücretlendirme kesinleşmemişse destek incelemesi gerekir.
V2'nin istek sınırları var mı?
Evet. Güncel varsayılan sınırlar hesap başına dakikada 120 istek, IP başına dakikada 600 istek ve hesap başına eşzamanlı 2 işlemdir. Paylaşılan hizmet kapasitesi de geçerlidir. POST gövdesi en fazla 64 KiB olabilir; toplu istekler anahtarla 50, IP denemesinde 10 öğe kabul eder. Bu üst sınırlarda her isteğin kabul edileceğini varsaymayın; HTTP 429 ve Retry-After değerine uyun.
Başarısız veya zaman aşımına uğrayan isteği yeniden gönderebilir miyim?
Her tahmin isteği normal tarifeye tabi yeni bir işlemdir. Zaman aşımı veya yanıtın kaybolması, kredi düşülmediğini kanıtlamaz. Tekrar göndermeden önce billing_status alanını kontrol edin; ücretlendirme kesinleşmemişse request_id ile destek ekibine başvurun. Kısmen başarılı toplu isteklerde, ücretlendirme kesinleştikten sonra yalnızca başarısız öğeleri yeniden gönderin. HTTP 429 yanıtında Retry-After değerine uyun.
V2 kod örneklerini ve araçlarını nerede bulabilirim?
V2 rehberlerinde cURL, JavaScript, Python, PHP, Java, C# ve Go örnekleri bulunur. Swagger ve Postman aynı V2 API tanımını kullanır. Girdi türünü seçin ve API anahtarınızı sunucu tarafındaki yapılandırmada saklayın.
V1'i kullanmaya devam edebilir miyim?
Evet. Mevcut V1 entegrasyonları kendi uç noktalarını ve yanıt biçimlerini kullanmaya devam eder. V1 ve V2 aynı API anahtarını ve kredi bakiyesini paylaşır; ancak istek alanları, yanıtları ve hata biçimleri farklıdır. Mevcut istemcinizin bakımı için ayrı V1 dokümantasyonunu, güncellemeye hazır olduğunuzda ise geçiş rehberini kullanın.
Gizlilik ve dosyalar
Verilerin nasıl işlendiğini öğrenin
Güncel işleme, saklama ve silme koşullarına ulaşın.
Başarıyla sonuçlanan GenderAPI sorguları kaydediliyor mu?
Hangi sorgu kayıtlarının, işletim kayıtlarının ve güvenlik günlüklerinin saklanabileceği, işleme amaçları ve silme süreçleri Gizlilik Politikası'nda açıklanır. Entegrasyonunuz için bu koşulları inceleyin ve gereksiz kişisel veri göndermeyin.
E-posta sorgularındaki girdiler kaydediliyor mu?
E-posta girdilerinin ve ilgili teknik kayıtların güncel işlenme koşulları için Gizlilik Politikası'nı inceleyin. E-posta adresi kişisel veri olabilir; yalnızca sorgunun gerektirdiği bilgiyi gönderin ve kendi hata ayıklama günlüklerinize tam adresi yazmaktan kaçının.
Yüklenen Excel veya CSV dosyaları ne kadar süre saklanır?
Yüklenen dosyaların saklanması, silinmesi ve yedeklerde işlenmesi Gizlilik Politikası'nda açıklanır. İhtiyaç duyduğunuz sonuçları dışa aktarın ve dosyaya artık gerek kalmadığında çalışma alanındaki silme kontrollerini kullanın. Kurumunuzun saklama gereksinimleriyle ilgili sorular için destek ekibine başvurun.
Hizmet sağlayıcıları sorgu veya yüklenen dosya verilerini işleyebilir mi?
Hizmet sağlayıcılarının veri işlemesi ve geçerli koruma önlemleri, Gizlilik Politikası ve alt işleyen bilgilerinde açıklanır. Verilerinizin nerede işlendiğini değerlendirirken bu kaynakları ve hesabınız için geçerli sözleşmeleri inceleyin.
Hesap ve destek
API anahtarınızı kullanın ve hesabınızı yönetin
Ücretsiz erişim, kimlik doğrulama, bakiye sorgulama ve destek.
GenderAPI'yi ücretsiz deneyebilir miyim?
Evet. Ücretsiz kayıtlı hesap günlük 200 kredi içerir. Bundan ayrı olarak, anahtarsız V2 denemesi genel IP adresi başına 24 saatlik dönemde 10 kredi sağlar; bu hak V1 ve aynı IP'deki diğer kullanıcılarla ortaktır. Her ikisinde de normal kredi tarifeleri geçerlidir; kredi sayısı her zaman HTTP istek sayısına eşit değildir.
Ücretsiz plan ve fiyatlandırma →IP üzerinden deneme erişimi →
API anahtarıyla nasıl kimlik doğrularım ve anahtarımı nasıl korurum?
Güvenilir sunucu kodundan Authorization: Bearer YOUR_API_KEY başlığını kullanın; POST isteklerine ayrıca Content-Type: application/json ekleyin. Gerçek anahtarı tarayıcı koduna, herkese açık kod depolarına veya günlüklere koymayın. Eksik, hatalı biçimde yazılmış veya sistemde tanınmayan anahtarlar IP denemesini kullanabilir; bu nedenle meta.access.mode değerinin api_key olduğunu doğrulayın. Sistemde kayıtlı olup devre dışı bırakılan, süresi dolan veya erişimi kısıtlanan anahtarlar IP denemesine geçmez.
Kalan kredilerimi nasıl öğrenebilirim?
Bearer anahtarınızla GET /api/v2/usage çağrısı yapın. Bu bakiye sorgusu ücretsizdir ve data.remaining_credits alanını döndürür. Anahtar gönderilmezse paylaşılan IP deneme bakiyesi okunur. V1 ve V2 aynı hesap bakiyesini kullanır; tahmin yanıtındaki remaining_credits değeri, işlemin tamamlandığı andaki bakiyedir.
Aboneliğimi nereden yönetebilir veya iptal edebilirim?
API anahtarınıza bağlı aboneliği yönetmek için GenderAPI uygulamasında oturum açın. Planınızı ve iptal seçeneklerini güncel hesap kontrollerinden inceleyin.
Fatura bilgilerimi nereden güncelleyebilirim?
Fatura ve ödeme ayarlarını, GenderAPI uygulamasında oturum açarak ilgili API anahtarı veya abonelik üzerinden yönetin.
Hatalı sonucu nasıl bildirebilirim veya entegrasyon desteği alabilirim?
API sürümünü, uç noktayı, request_id değerini ve sorunu yeniden üreten küçük bir örneği destek ekibine gönderin. Varsa hata kodunu ekleyin; API anahtarınızı ve hassas kişisel verileri çıkarın.
Teknik bilgi merkezi
Entegrasyon ve sorumlu kullanım rehberleri
V2 yanıtları, hatalar, kimlik doğrulama ve sorumlu kullanım hakkında ayrıntılı açıklamalar.
Sonuçlar, güven skoru ve sorumlu kullanım
V2'de cinsiyet belirlenemediğinde gender alanı JSON null değerini alır; metin olarak yazılmış null kullanılmaz. İsim birden fazla kategoride kullanılabilir veya mevcut kanıt yetersiz olabilir. Varsa result_status ve reason alanlarını inceleyin. Sonucu zorla bir kategoriye atamak yerine bilinmeyen olarak koruyun. Başarılı ancak sonucu bilinmeyen sorgular, seçilen tarifeye göre ücretlendirilir. İstek veya sağlayıcı hataları ayrı hata durumlarıdır; ücretlendirme bilgileri meta.usage içinde yer alır.
Yanıtın tamamını okuyun →GenderAPI'nin doğruluğu nasıl değerlendirilir?Anlamlı bir doğruluk değerlendirmesi; test edilen grubu, tarihi, örnekleme yöntemini, bilinmeyen sonuçların nasıl ele alındığını ve bölge ile yazı sistemi bazındaki sonuçları açıklar. Güncel metodoloji sayfası ölçülmüş bir doğruluk yüzdesi değil, değerlendirme protokolü sunar. V2'de confidence ve confidence_kind alanları her sonucun dayandığı kanıtı açıklar; kullanımınızı temsil eden verilerle yapılmış bir performans ölçümünün yerini tutmaz.
Yanıtın tamamını okuyun →Veri kaynakları, gizlilik ve uyum
Veri kaynakları sayfası; kaynak kategorileri, seçim ölçütleri, lisans koşulları ve coğrafya ya da yazı sistemiyle ilgili sınırlamaların belgelenmesi için bir çerçeve açıklar. Sayfada henüz incelemesi tamamlanmış bir kaynak kataloğu yayımlanmamıştır. Entegrasyonunuzun kaynak gereksinimleri için bu sayfayı inceleyin ve destek ekibiyle iletişime geçin. Belgelenmemiş bir kaynak, veri kümesi büyüklüğü veya kapsam bilgisi varsaymayın.
Yanıtın tamamını okuyun →İsim verileri ne sıklıkla güncellenir?Güncel veri kaynakları sayfası, tüm isim kayıtları ve işleme kuralları için ortak bir güncelleme takvimi belirtmez. Veri güncelliği kullanımınızı etkiliyorsa ilgili veri kümesini veya iş akışını destek ekibine sorun ve kullanımınızı temsil eden sonuçları değerlendirin. Bir sayfanın gözden geçirilme tarihi, tüm kayıtların o tarihte güncellendiği anlamına gelmez.
Yanıtın tamamını okuyun →GenderAPI'nin GDPR ve veri işleme belgelerini nasıl değerlendirmeliyim?Gizlilik Politikası, GDPR bilgileri, Veri İşleme Sözleşmesi ve alt işleyen listesi, yayımlanan veri işleme koşullarını ve koruma önlemlerini açıklar. Güncel belgeleri ve hesabınız için geçerli sözleşmeleri inceleyin. İşleme rolleri, veri aktarımları veya ilgili kişi talepleri konusunda kurumunuza özel sorular için GenderAPI ile iletişime geçin. Genel bir SSS yanıtı, geçerli sözleşmenin yerine geçmez.
Yanıtın tamamını okuyun →API kullanımı, hatalar ve krediler
Güvenilir sunucu kodundan Authorization: Bearer YOUR_API_KEY başlığını kullanın. V2 POST isteklerine ayrıca Content-Type: application/json ekleyin. GET /api/v2/gender, sorgu parametresi olarak key alanını da kabul eder; ancak başlık kullanmak kimlik bilgilerini tarayıcı adresinden uzak tutar. Eksik, hatalı biçimde yazılmış veya sistemde tanınmayan anahtarlar paylaşılan IP denemesini kullanabilir. Hesap entegrasyonunda meta.access.mode değerinin api_key olduğunu kontrol edin. Sistemde kayıtlı olup devre dışı bırakılan, süresi dolan veya erişimi kısıtlanan anahtarlar denemeye geçmez.
Yanıtın tamamını okuyun →İstek sınırlarını ve yeniden denemeleri nasıl yönetmeliyim?V2, istek hızı ve eşzamanlı işlem sınırları uygular; HTTP 429 ve Retry-After değerine uyun. Tekrarlanan her tahmin isteği normal tarifeye tabi yeni bir işlemdir. Zaman aşımı, kaybolan yanıt veya kesinleşmemiş ücretlendirme durumunda isteği otomatik olarak tekrarlamayın. Önce code, action ve meta.usage.billing_status alanlarını inceleyin; billing_reconciliation_required için request_id ile destek ekibine başvurun. Yalnızca ücretlendirme kesinleştiğinde ve belgelenen action yeni bir denemeye izin verdiğinde, bekleme süresini kademeli artırarak sınırlı sayıda yeniden deneyin.
Yanıtın tamamını okuyun →V2 API hata kodlarını nasıl işlemeliyim?V2 API hataları, HTTP hata durum kodları ve RFC 9457 Problem Details biçimiyle birlikte kararlı code ve action alanlarını kullanır. İşlemi detail metnini eşleştirerek değil, bu alanlara göre yönetin ve destek için request_id değerini saklayın. Başarılı ancak sonucu bilinmeyen bir sorgu, hata değildir. Toplu yanıt HTTP 200 olsa da tek tek öğelerde hata bulunabilir. Ara sunucu JSON olmayan bir hata döndürebilir; yanıtın kaybolması veya okunamaması, kredi düşülmediğini kanıtlamaz.
Yanıtın tamamını okuyun →Kalan kredilerimi ve kullanımımı nasıl kontrol ederim?Güvenilir sunucu kodundan Bearer API anahtarınızla GET /api/v2/usage çağrısı yapın. Bu istek ücretsizdir ve data.remaining_credits alanını döndürür; anahtar gönderilmezse paylaşılan IP deneme bakiyesi okunur. V1 ve V2 aynı hesap bakiyesini kullanır. Tahmin yanıtındaki meta.usage, o işlemin maliyetini ve tamamlandığı andaki bakiyeyi bildirir; eşzamanlı istekler bakiyeyi değiştirebilir. Kimlik bilgilerini günlüklere yazmayın. Bakiye sorgusunu, yanıtı kaybolan belirli bir isteğin ücretlendirilmediğinin kanıtı olarak kullanmayın.
Yanıtın tamamını okuyun →V1 ve V2 arasındaki geçişi nasıl yönetmeliyim?Yeni entegrasyonlarda V2 kullanın; mevcut V1 istemcilerini taşımaya karar verene kadar belgelenmiş V1 uç noktalarında tutun. İki sürüm API anahtarlarını ve kredileri paylaşır, ancak istek alanları, yanıt yapıları ve hata biçimleri farklıdır. Geçiş rehberini izleyin; başarılı, bilinmeyen ve hatalı sonuçları test edin. Uç noktayı değiştirmeden önce yanıtı işleyen kodunuzu güncelleyin. Mevcut entegrasyonlar için V1 dokümantasyonu erişilebilir olmaya devam eder.
Yanıtın tamamını okuyun →Hizmet hatalarını ve erişilebilirliği nasıl izleyebilirim?Bir istek başarısız olduğunda dönen hata koduyla hizmet hatasını; geçersiz girdi, hesap erişimi, tükenmiş kredi veya istek sınırı sorunlarından ayırın. Entegrasyonunuzda istek başarısını ve gecikmeyi izleyin. Açıklanamayan bir hata veya ücretlendirme belirsizliği için request_id ile destek ekibine başvurun. Erişilebilirlik iddialarını ölçülmüş izleme verilerine dayandırın; bu SSS garantili bir çalışma süresi yüzdesi belirtmez.
Yanıtın tamamını okuyun →Hâlâ yardıma mı ihtiyacınız var?
Yeniden üretilebilir bir örnek gönderin
API sürümünü, uç noktayı, request_id değerini ve küçük bir örneği ekleyin. Göndermeden önce API anahtarınızı ve hassas kişisel verileri çıkarın.