Обработка на грешки

Вижте удостоверяване за настройка на API ключ и импортиране на CAR файлове за групово качване — двата най-чести източника на грешки при интеграция.

Всички грешки връщат JSON обект с поле error:

{
  "error": "not enough storage, please upgrade your plan"
}

Кодове на състоянието

Код	Значение	Чести причини
400	Невалидна заявка	Липсващи или невалидни параметри, неподдържан тип съдържание, невалидно JSON тяло.
401	Неоторизиран	Липсващ или невалиден API ключ.
402	Изисква се плащане	Лимитът за съхранение е надвишен — надградете плана си или изчакайте месечното нулиране.
404	Не е намерен	CID на файла или потребителят не е намерен.
429	Твърде много заявки	Лимитът за честотна лента на gateway е надвишен — изчакайте месечното нулиране.
500	Вътрешна грешка	Неочаквана грешка на сървъра — опитайте отново или се свържете с поддръжката.

Грешки от страна на клиента (4xx)

4xx кодовете показват проблем със самата заявка. Проверете дали API ключът ви е валиден (401), дали тялото на заявката е коректно форматиран JSON (400) и дали не сте надвишили квотата си за съхранение (402). Тези грешки не се решават с повторен опит без промяна на заявката — коригирайте параметрите или удостоверяването си и опитайте отново.

Грешки от страна на сървъра (5xx)

Отговор 500 означава неочаквано състояние от страна на сървъра, а не проблем със заявката ви. Изчакайте кратко и опитайте отново; ако грешката продължава, свържете се с поддръжката и посочете ID на заявката от заглавките на отговора, за да ускорите разследването.