Регистрация

Разное

Коды ответов 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Попытка сделать запрос к серверу апи, который не обслуживает данного пользователя. В случае получения этого кода правильный домен можно получить в поле 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.