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 bu yapıyı izler:

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

Durum Kodları

Kod	Anlam	Ne Zaman Olur
400	Bad Request	Eksik ya da geçersiz parametreler
402	Payment Required	Aylık ödül kotasına ulaşıldı ya da özellik daha yüksek bir plan gerektiriyor
403	Forbidden	Plan sınırına ulaşıldı (ör. düzenleyici ya da rozet üst sınırı)
404	Not Found	İstenen kaynak mevcut değil
429	Too Many Requests	Hız sınırı aşıldı
500	Internal Server Error	Sunucuda beklenmeyen bir hata oluştu

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

Gerekli parametreler eksik

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

Çözüm: Tüm gerekli parametreleri istek gövdenize ekleyin. Tam liste için uç nokta dokümantasyonuna 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ü de içeren 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 gerektirir. Alıcı adları en az 5 karakter gerektirir.

Düzenleyici doğrulanmadı

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

Çözüm: Önce düzenleyiciyi doğrulayın. Doğrulama bağlantısı için düzenleyici e-postasını kontrol edin ya da Verify Issuer uç noktasını kullanın.

Aylık ödül kotasına ulaşıldı

{ "error": "monthly award quota reached" }

Çözüm: Bu fatura dönemi için planınıza dahil olan tüm ödülleri kullandınız (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo). Sonraki sıfırlamayı bekleyin ya da planınızı yükseltin. Planlar ve Fatura sayfasına bakın.

Plan sınırına ulaşıldı

{ "error": "issuer limit reached for your plan" }

Çözüm: Düzenleyiciler, rozetler ya da API anahtarlarında plan üst sınırınıza ulaştınız. Kullanılmayan bir kaynağı silin ya da planınızı yükseltin.

Blockchain için Pro gerekir

{ "error": "blockchain verification requires the Pro plan" }

Çözüm: blockchain parametresi yalnızca Pro planında kullanılabilir. Zincir üstü doğrulamayı etkinleştirmek için yükseltin.

Desteklenmeyen blockchain

{ "error": "unsupported blockchain, only 'matchain' is supported" }

Çözüm: Şu anda blockchain parametresi olarak yalnızca matchain desteklenir.

Kaynağın bağımlılıkları var

{ "error": "issuer has badges and cannot be deleted" }

Çözüm: Düzenleyiciyi silmeden önce düzenleyici altındaki tüm rozetleri silin. Benzer şekilde, bir rozeti silmeden önce rozet altındaki tüm ödülleri silin.

Yetkili değil

{ "error": "not authorized" }

Çö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 parametresinden tüm HTML etiketlerini kaldırın.