Hatalar

Bir API isteği başarısız olduğunda badges.ninja, uygun bir HTTP durum koduyla birlikte JSON hata yanıtı döndürür.

Hata Biçimi

Tüm hatalar şu yapıyı izler:

{
  "error": "description of what went wrong"
}

Durum Kodları

Kod	Anlamı	Ne Zaman Olur
400	Bad Request	Eksik veya geçersiz parametreler, plan sınırına veya kotaya ulaşılması, özelliğin daha yüksek bir plan gerektirmesi ya da yetkisiz erişim — tüm doğrulama hataları 400 döndürür
402	Payment Required	Kredi tükenmesi için ayrılmıştır. Badges API şu anda kredi düşmediğinden bu kod pratikte hiç döndürülmez
404	Not Found	İstenen kaynak mevcut değil
500	Internal Server Error	Sunucuda beklenmeyen bir hata oluştu

403 veya 429 yoktur: yetkilendirme hataları 400 ("not authorized") döndürür ve uygulama katmanında hız sınırlaması yoktur.

Sık Karşılaşılan Hatalar ve Çözümleri

Eksik zorunlu parametreler

{ "error": "missing required parameters: name, url, email" }

Çözüm: Tüm zorunlu parametreleri istek gövdenize ekleyin. Tam liste için uç noktanın belgelerine bakın.

Geçersiz e-posta

{ "error": "invalid email" }

Çözüm: user@domain.com biçiminde geçerli bir e-posta adresi girin.

Geçersiz URL

{ "error": "invalid URL" }

Çözüm: Protokol dahil tam bir URL girin, ör. https://example.com.

Ad çok kısa

{ "error": "name must be at least 3 characters" }

Çözüm: Daha uzun bir ad kullanın. Düzenleyici adları en az 3 karakter olmalıdır. Alıcı adları en az 5 karakter olmalıdır.

Düzenleyici doğrulanmamış

{ "error": "issuer must be verified before creating badges" }

Çözüm: Önce düzenleyiciyi doğrulayın. Düzenleyici e-postasındaki doğrulama bağlantısını kontrol edin veya Düzenleyiciyi Doğrula uç noktasını kullanın.

Kimlik bilgisi kotasına ulaşıldı (400)

{ "error": "Your Free plan reached its credential limit (1200/1200) — your allowance renews on your plan anniversary, or upgrade to Starter" }

Çözüm: Yıllık kimlik bilgisi havuzunuzun tamamını kullandınız (Free: 1.200/yıl, Starter: 12.000/yıl, Pro: 120.000/yıl). Havuz, takvim ayı başında değil, hesabınızın kayıt yıldönümünde sıfırlanır. Daha yüksek bir hak için planınızı yükseltin. Bkz. Planlar ve Faturalandırma.

Plan sınırına ulaşıldı (400)

{ "error": "Your Free plan reached its issuer limit (2/2) — delete an issuer or upgrade to Starter" }

Rozet sınırı da aynı biçimi kullanır:

{ "error": "badge limit reached (5/5 on the starter plan) — delete a badge or upgrade your plan" }

Çözüm: Planınızın düzenleyici veya rozet sınırına ulaştınız. Kullanılmayan bir kaynağı silin veya planınızı yükseltin.

Kaynağın bağımlılıkları var (400)

{ "error": "issuer has 3 badge(s) linked — delete the badges first" }

Çözüm: Düzenleyiciyi silmeden önce ona bağlı tüm rozetleri silin. Benzer şekilde, bir rozeti silmeden önce o rozet altındaki tüm kimlik bilgilerini silin.

Yetkisiz (400)

{ "error": "not authorized" }

Yetkilendirme hataları birer doğrulama hatasıdır, bu yüzden 400 döndürür (401 veya 403 değil).

Çözüm: Yalnızca sahip olduğunuz kaynakları değiştirebilirsiniz. Doğru API anahtarını kullandığınızdan emin olun.

Paylaşım metninde HTML

{ "error": "HTML tags are not allowed" }

Çözüm: Paylaşım metni düz metin olmalıdır. text parametresindeki tüm HTML etiketlerini kaldırın.