Kļūdas

Kad API pieprasījums neizdodas, badges.ninja atgriež JSON kļūdas atbildi ar atbilstošu HTTP statusa kodu.

Kļūdas formāts

Visas kļūdas seko šai struktūrai:

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

Statusa kodi

Kods	Nozīme	Kad tas notiek
400	Bad Request	Trūkst vai nederīgi parametri
402	Payment Required	Sasniegta ikmēneša apbalvojumu kvota vai funkcija prasa augstāku plānu
403	Forbidden	Sasniegts plāna ierobežojums (piemēram, izsniedzēja vai nozīmes maksimums)
404	Not Found	Pieprasītais resurss nepastāv
429	Too Many Requests	Pārsniegts ātruma ierobežojums
500	Internal Server Error	Serverī radās negaidīta kļūda

Bieži sastopamas kļūdas un risinājumi

Trūkst obligātu parametru

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

Risinājums: iekļaujiet visus obligātos parametrus sava pieprasījuma pamattekstā. Pilnam sarakstam pārbaudiet galapunkta dokumentāciju.

Nederīgs e-pasts

{ "error": "invalid email" }

Risinājums: norādiet derīgu e-pasta adresi formātā user@domain.com.

Nederīgs URL

{ "error": "invalid URL" }

Risinājums: norādiet pilnu URL, ieskaitot protokolu, piemēram, https://example.com.

Nosaukums pārāk īss

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

Risinājums: izmantojiet garāku nosaukumu. Izsniedzēja nosaukumiem nepieciešamas vismaz 3 rakstzīmes. Saņēmēja vārdiem nepieciešamas vismaz 5 rakstzīmes.

Izsniedzējs nav pārbaudīts

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

Risinājums: vispirms pārbaudiet izsniedzēju. Pārbaudiet izsniedzēja e-pastu, lai atrastu apstiprināšanas saiti, vai izmantojiet galapunktu Pārbaudīt izsniedzēju.

Sasniegta ikmēneša apbalvojumu kvota

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

Risinājums: esat izlietojis visus savā plānā iekļautos apbalvojumus šim norēķinu periodam (Free: 100/mēn, Starter: 1 000/mēn, Pro: 10 000/mēn). Gaidiet nākamo atiestatījumu vai jauniniet savu plānu. Skatiet Plāni un norēķini.

Sasniegts plāna ierobežojums

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

Risinājums: esat sasniedzis sava plāna ierobežojumu izsniedzējiem, nozīmēm vai API atslēgām. Dzēsiet neizmantotu resursu vai jauniniet savu plānu.

Blokķēdei nepieciešams Pro

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

Risinājums: parametrs blockchain ir pieejams tikai Pro plānā. Jauniniet, lai iespējotu ķēdes pārbaudi.

Neatbalstīta blokķēde

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

Risinājums: pašlaik kā blokķēdes parametrs tiek atbalstīts tikai matchain.

Resursam ir atkarības

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

Risinājums: dzēsiet visas nozīmes zem izsniedzēja, pirms dzēšat izsniedzēju. Līdzīgi dzēsiet visus apbalvojumus zem nozīmes, pirms dzēšat nozīmi.

Nav autorizēts

{ "error": "not authorized" }

Risinājums: jūs varat modificēt tikai tos resursus, kurus jums pieder. Pārliecinieties, ka izmantojat pareizo API atslēgu.

HTML dalīšanās tekstā

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

Risinājums: dalīšanās tekstam jābūt vienkāršam tekstam. Noņemiet visus HTML tagus no teksta parametra.