Кодови грешака

Када комуницирате са СМСБАТ АПИ-јем, можете наићи на грешке. Користимо конвенционалне ХТТП кодове одговора да укажемо на успех или неуспех АПИ захтева.

генерално:

• Кодови у опсегу 2кк указују на успех. – Кодови у опсегу „4кк“ указују на грешку која није успела с обзиром на дате информације (нпр., изостављен је обавезни параметар, тип поруке је неважећи итд.).
• Кодови у опсегу 5кк указују на грешку са нашим серверима.

ХТТП статусни кодови

Код	Статус	Опис
200	ОК	Захтев је успео.
400	Лош захтев	Захтев је био неприхватљив, често због недостатка потребног параметра или неисправног ЈСОН-а.
401	Неовлашћено	Није наведен важећи АПИ кључ или аутентификација није успела.
403	Забрањено	АПИ кључ нема дозволе за извршавање захтева или је ваш налог суспендован.
404	Није пронађено	Тражени ресурс не постоји.
415	Неподржани тип медија	Заглавље Цонтент-Типе недостаје или није подешено на апплицатион/јсон.
422	Непроцесни ентитет	Захтев је правилно форматиран, али је садржао семантичке грешке (нпр. неважећи формат броја телефона).
429	Превише захтева	Превише захтева је пребрзо погодило АПИ. Препоручујемо експоненцијално повлачење ваших захтева.
500, 502, 503, 504	Грешке сервера	Нешто је пошло по злу на крају СМСБАТ-а.

Формат одговора на грешку

Када АПИ захтев резултира грешком, тело одговора садржи ЈСОН објекат са више детаља о проблему.

ЦОДЕ_БЛОЦК_0

Кодови грешака пословне логике (интерни кодови)

Поред ХТТП статусних кодова, можемо да вратимо одређени интерни код да бисмо вам помогли да идентификујете тачан разлог за грешку.

Интерни код	Опис	Предложена радња
1001	Неважећи формат захтева	Уверите се да је тело вашег захтева важећи ЈСОН.
1002	Недостаје обавезно поље	Проверите својство мессаге у одговору да видите које поље недостаје.
1003	Неважећи број телефона	Уверите се да је број примаоца у формату Е.164 (нпр. „380501234567“).
1004	Нерегистровано алфа име	Параметар „од“ садржи алфа назив који није одобрен за ваш налог.
1005	Недовољна равнотежа	Ваш налог нема довољно средстава за обраду кампање за размену порука.
1006	Неважећи тип поруке	Параметар типе мора да буде један од подржаних типова (нпр. смс, вибер_промо).
1007	Шаблон није пронађен	Захтевани ИД Вибер/ОТП шаблона је неважећи или није одобрен.
1008	Неважећи предмети вртешке	Вибер карусел мора да садржи између 2 и 5 ставки.

[!САВЕТ] Ако наиђете на код грешке који није овде наведен, или ако верујете да је грешка враћена грешком, контактирајте хелп@смсбат.цом и наведите тачан садржај одговора и заглавља.