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.
{
"status": false,
"errno": 94,
"errmsg": "invalid or missing key"
}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.
access deniedSorgu, yetkilendirilmemiş bir IP adresinden veya yönlendiren kaynaktan geldi.
invalid country codecountry değeri desteklenen bir ISO 3166-1 alpha-2 kodu değil.
name not set || email not set || username not setSorguda zorunlu name, email veya username parametresi bulunmuyor.
too many names || too many emails || too many usernamesSorgu toplu işlem sınırını aşıyor: 100 isim, 50 e-posta veya 50 kullanıcı adı.
query limit reachedAPI anahtarında kullanılabilir kredi kalmadı.
invalid or missing keyAPI anahtarı eksik veya sistemde bulunamadı.
API key has expiredAPI anahtarıyla ilişkili paketin kullanım süresi doldu.
Hata yönetimi önerileri
Güvenli biçimde durun ve kör yeniden denemelerden kaçının
Ö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.
Kimlik bilgilerini koruyun
API anahtarlarını sunucuda tutun; uygulama logları, tarayıcı çıktısı ve destek ekran görüntülerinde gizleyin.
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.
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ı