Реєстрація

Різне

Коди відповідей API

Список можливих статусів SMS повідомлень

URL-кодування рядків

Коди відповідей API

КодТипОпис
0integerОперація завершена успішно.
1integerПомилка валідації передаваних даних під час створення або поновлення будь-якої сутності. В полі data представлена інформація про те, які поля заповнені невірно. Слід виправити помилки і повторити запит з новими даними.
2integerВказаний запис не знайдено. Швидше за все вона була видалена, ID запису вказаний невірно або у користувача, що намагається отримати доступ до цього запису, немає відповідних прав доступу до нього.
3integerНевизначена помилка додатку. Зверніться в службу підтримки і повідомте деталі запиту, при якому вона була отримана.
4integerНевірно вказано параметр module. Перевірте правильність написання параметра в документації до API.
5integerНевірно вказано параметр method. Перевірте правильність написання параметра в документації до API.
6integerНевірно вказано параметр format. Перевірте правильність написання параметра в документації до API.
8integerПомилка входу в систему. Помилка виникає у випадках: 1. Неправильно зазначених даних для входу. 2. Коли під час роботи з системою сесія користувача закінчилася або була примусово закрита сервером. Більш детальну інформацію можна побачити в полі message.
9integerПомилка доступу до зазначеного методу
10integerПомилка під час збереження даних на сервері безпосередньо в процесі виконання даної операції. Зазвичай ця помилка пов'язана з одночасним доступом до даних з декількох клієнтів або зміною умов збереження даних в процесі їх збереження.
11integerДеякі обов'язкові параметри відсутні в запиті. Перевірте правильність написання параметрів в документації до API і доповніть запит необхідними параметрами.
12integerВхідний параметр запиту не відповідає встановленим умовам або обмеженням. Даний код помилки виникає у випадках, коли при виконанні запиту з параметрами будь-який параметр порушує обмеження. Схоже на помилку валідації атрибутів, але може бути отримано в запитах, які не здійснюють створення або зміни даних.
13integerСпроба зробити запит до сервера API, який не обслуговує даного користувача. У разі отримання цього коду правильний домен можна отримати в поле data
14integerДана помилка виникає в разі якщо аккаунт користувача заблоковано або вилучено
15integerПомилка під час виконання будь-якої операції, яка не пов'язана з оновленням даних. Деталі даної помилки вказані в поле message відповіді API.
30integerПомилка перевищення допустимого ліміту операцій в проміжок часу. Дана помилка виникає при надмірно частих зверненнях до одного і того ж методу API. У разі виникнення помилки слід зменшити частоту запитів.
98integerОперація виконана не в повному обсязі, а лише з частиною даних. Зазвичай даний код повертається при будь-яких масових операціях, під час виконання яких деякі елементи не були оброблені через помилки або обмеження, але частина елементів оброблена. У разі отримання цього коду можна отримати інформацію про те, які елементи були оброблені, а які ні і з якими помилками, отримавши вміст поля data.
99integerЖоден з елементів масової операції не був оброблений. Детальну інформацію про помилки в кожному конкретному елементі можна отримати в поле data, а загальний опис помилки в полі message
100integerДаний код не є помилкою і означає, що операція була відправлена в фонове виконання. У цьому випадку поле data містить ID фонової операції, процес і закінчення якої можна відстежити за допомогою Taskqueue::GetStatus
999integerЗагальна помилка. Деталі можна отримати в полі message.

Список можливих статусів SMS повідомлень

СтатусОкончательныйОпис
NEWнетНове повідомлення, ще не було відправлено
ENQUEUDнетПройшло модерацію і поставлено в чергу на відправку
ACCEPTDнетВідправлено з системи і прийнято оператором для подальшої пересилки одержувачу
UNDELIVдаНе доставлено одержувачу
REJECTDдаВідхилено оператором по одній з безлічі причин - невірний номер одержувача, заборонений текст та інше.
PDLIVRDнетНе всі сегменти повідомлення доправлені одержувачу (цей статус може бути тільки у повідомлень, але не у сегментів). Деякі оператори повертають звіт тільки про перший доставлений сегмент, тому таке повідомлення після закінчення терміну життя перейде в статус, встановлений для першого сегмента.
DELIVRDдаДоставлено одержувачу повністю
EXPIREDдаДоставка не вдалася так як закінчився термін життя повідомлення (за замовчуванням 1 доба)
DELETEDдаВидалено через обмеження і не доставлено одержувачу

URL-кодування рядків

У кожній серверній мові в тому чи іншому вигляді є функція, яка повертає рядок, в якому всі не цифро-буквені символи, крім -_. повинні бути замінені знаком відсотка (%), за яким йдуть два шістнадцятирічних числа, а пробіли закодовані як знак додавання (+). Рядок кодується тим же способом, що і POST-дані веб-форми, тобто за типом контенту application/x-www-form-urlencoded. Це відрізняється від кодування по RFC 3986 в тому, що з історичних причин, пробіли кодуються як знак «плюс» (+).

PHP

В мові PHP це функція urlencode.