Грешки

Когато 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.