Грешке

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

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

Све грешке имају ову структуру:

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

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

Код	Значење	Када се јавља
400	Bad Request	Недостајући или неисправни параметри, достигнуто ограничење плана или квота, функција захтева виши план или нема овлашћења — све грешке валидације враћају 400
402	Payment Required	Резервисано за исцрпљење кредита. API за значке тренутно не одбија кредите, па се овај код у пракси никада не враћа
404	Not Found	Тражени ресурс не постоји
500	Internal Server Error	Дошло је до неочекиване грешке на серверу

Не постоје 403 ни 429: грешке овлашћења враћају 400 ("not authorized"), а ограничавање брзине на нивоу апликације не постоји.

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

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

{ "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" }

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

Достигнута квота акредитива (400)

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

Решење: Искористили сте цео годишњи фонд акредитива (Free: 1.200/годишње, Starter: 12.000/годишње, Pro: 120.000/годишње). Фонд се ресетује на годишњицу регистрације вашег налога — а не на границу календарског месеца. Надоградите план за већу квоту. Погледајте Планови и наплата.

Достигнуто ограничење плана (400)

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

Ограничење броја значки има исти облик:

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

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

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

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

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

Нема овлашћења (400)

{ "error": "not authorized" }

Грешке овлашћења су грешке валидације, па враћају 400 (а не 401 или 403).

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

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

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

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