API hata kodları

API hatalarını güvenle yönetin

Başarısız GenderAPI sorgusunu sabit errno değeriyle tanımlayın ve uygun düzeltme adımını uygulayın.

Önce kontrol edinstatus: falseerrnoerrmsg

Yanıt yapısı

Hata nesnesini doğru okuyun

Sorgu başarısız olduğunda JSON yanıtındaki status değeri false olur. Uygulama mantığında sayısal errno değerini; log veya kullanıcıya yönelik tanı bilgisinde errmsg alanını kullanın.

JSON · örnek hata
{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}
Uygulama kuralı: Koşulları errmsg metninin bire bir yazılışına göre değil, errno değerine göre oluşturun. Açıklama metni değişse bile entegrasyonunuz kararlı kalır.

Eksiksiz referans

GenderAPI hata kodları

Aşağıdaki değerler güncel İngilizce GenderAPI dokümantasyonuyla aynıdır. Aynı sorguyu tekrarlamadan önce hatanın nedenini düzeltin.

errno50
access denied

Sorgu, yetkilendirilmemiş bir IP adresinden veya yönlendiren kaynaktan geldi.

API anahtarına tanımlanan erişim kısıtlamalarını kontrol edin.
errno90
invalid country code

country değeri desteklenen bir ISO 3166-1 alpha-2 kodu değil.

Tekrar denemeden önce ülke kodunu doğrulayın ve standartlaştırın.
errno91
name not set || email not set || username not set

Sorguda zorunlu name, email veya username parametresi bulunmuyor.

Çağırdığınız endpoint için gereken girdiyi ekleyin.
errno92
too many names || too many emails || too many usernames

Sorgu toplu işlem sınırını aşıyor: 100 isim, 50 e-posta veya 50 kullanıcı adı.

Girdileri daha küçük gruplara ayırarak ayrı ayrı gönderin.
errno93
query limit reached

API anahtarında kullanılabilir kredi kalmadı.

Sorgu işlerini duraklatın ve hesap bakiyesine kredi ekleyin.
errno94
invalid or missing key

API anahtarı eksik veya sistemde bulunamadı.

Kimlik bilgisi aktarımını kontrol edin ve geçerli bir sunucu tarafı anahtarı kullanın.
errno99
API key has expired

API anahtarıyla ilişkili paketin kullanım süresi doldu.

Yeni bir sorgu göndermeden önce paketi yenileyin.

Hata yönetimi önerileri

Güvenli biçimde durun ve kör yeniden denemelerden kaçının

01

Önce girdiyi doğrulayın

Eksik girdileri, geçersiz ülke kodlarını ve sınırı aşan toplu verileri API'ye ulaşmadan reddedin.

02

Kimlik bilgilerini koruyun

API anahtarlarını sunucuda tutun; uygulama logları, tarayıcı çıktısı ve destek ekran görüntülerinde gizleyin.

03

Yalnız gerektiğinde tekrar deneyin

Bu hatalar girdi düzeltmesi veya hesap işlemi gerektirir. Aynı isteği değiştirmeden tekrarlamak sorunu çözmez.

TypeScript · yanıt kontrolü
type GenderApiError = {
  status: false;
  errno: number;
  errmsg: string;
};

if (response.status === false) {
  handleGenderApiError(response.errno, response.errmsg);
}

Tanı bilgilerini gizli tutun

Hata numarasını şirket içi bir sorgu kimliğiyle kaydedin ancak API anahtarını hiçbir zaman loglamayın. Kullanıcıya ham kimlik bilgileri veya iç sorgu verileri yerine kısa ve uygulanabilir bir mesaj gösterin.

Dokümantasyon tamamlandı

GenderAPI ile geliştirmeye devam edin

Kullanım ve kotaKullanılabilir kredileri izleyin →FiyatlarKredi paketlerini karşılaştırın →