Грешке

Када API захтев не успе, badges.ninja враћа JSON одговор о грешци са одговарајућим HTTP статусним кодом.

Формат грешке

Све грешке прате ову структуру:

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

Статусни кодови

Код	Значење	Када се дешава
400	Bad Request	Недостајући или неисправни параметри
402	Payment Required	Достигнут месечни лимит награда или функција захтева виши план
403	Forbidden	Достигнут лимит плана (нпр. издаваоца или значки)
404	Not Found	Тражени ресурс не постоји
429	Too Many Requests	Премашена стопа захтева
500	Internal Server Error	Неочекивана грешка на серверу

Уобичајене грешке и решења

Недостају обавезни параметри

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

Решење: Укључите све обавезне параметре у тело захтева. Проверите документацију крајње тачке за пуну листу.

Неисправан имејл

{ "error": "invalid email" }

Решење: Проследите исправну имејл адресу у формату user@domain.com.

Неисправан URL

{ "error": "invalid URL" }

Решење: Проследите пуну URL адресу са протоколом, нпр. https://example.com.

Име прекратко

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

Решење: Користите дуже име. Имена издаваоца захтевају минимум 3 карактера. Имена прималаца захтевају минимум 5 карактера.

Издавалац није верификован

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

Решење: Прво верификујте издаваоца. Проверите имејл издаваоца за верификациони линк или користите крајњу тачку Verify Issuer.

Достигнут месечни лимит награда

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

Решење: Искористили сте све награде плана за овај обрачунски период (Free: 100/мес, Starter: 1 000/мес, Pro: 10 000/мес). Сачекајте следећи ресет или унапредите план. Видите Планови и наплата.

Достигнут лимит плана

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

Решење: Достигли сте лимит плана за издаваоце, значке или API кључеве. Обришите неискоришћен ресурс или унапредите план.

Блокчејн захтева Pro

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

Решење: Параметар blockchain доступан је само на плану Pro. Унапредите план да бисте омогућили on-chain верификацију.

Неподржан блокчејн

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

Решење: Тренутно је само matchain подржан као параметар блокчејна.

Ресурс има зависности

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

Решење: Обришите све значке под издаваоцем пре брисања издаваоца. Слично, обришите све награде под значком пре брисања значке.

Није овлашћено

{ "error": "not authorized" }

Решење: Можете мењати само сопствене ресурсе. Уверите се да користите исправан API кључ.

HTML у тексту за дељење

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

Решење: Текст за дељење мора бити обичан текст. Уклоните све HTML тагове из параметра text.