API / Справка

Формат номера

И в API, и в личном кабинете сервис принимает номера в формате 7xxxxxxxxxx, например: «79607728877». Если формат не соответствует указанному, то сервис максимально пытается привести предоставленный номер к формату федерального номера России. Т. е. номера следующих форматов сервис примет: «+7 960 772-88-77», «8 960 772 88 77», «960 772-88-77» и т. д.

Вы можете использовать любой удобный вам формат федерального номера.

Допустимые подмены

В подмене допустимы символы:

  • Английские буквы: a-z A-Z
  • Арабские цифры: 0-9
  • Символы: @ $ # ! ' " % & * + , - . = : ; ( )

При этом в подмене всегда должна быть хотя бы одна английская буква, а ее длина не должна превышать 11 символов.

Список ошибок

Ошибки авторизации
-1 Неверный логин/пароль.
-101 Ваш аккаунт заблокирован.
Ошибки при отправке СМС
-2 Неверный номер получателя (номера всех получателей).
-3 Пустое сообщение.
-4 Неверная подмена.
-5 Использование данной подмены без дополнительного согласования запрещено.
-6 Неверный формат времени отправки.
-7 Недостаточно баланса.
-8 Не заполнены платежные данные.
-9 Неверное время для отправки на free-номер.
-11 Подмена не зарегистрирована за пользователем.
-12 Используются символы кириллицы и латиницы в одном слове.
-13 В тексте используется запрещенное слово.
Ошибки при запросе статуса СМС
-40 СМС с указанным ID не найдена.
-50 Рассылка с указанным ID не найдена.
Ошибки при работе с записной книжкой
-60 Контакт с указанным ID не найден.
Ошибки запроса
-31 Неверный параметр mode. Допустимые значения: "prod" или "dev".
-32 Неверный формат. На данный момент поддерживается только json.
-33 Ошибка разбора запроса: проверьте синтаксис.
-100 Технические работы. Пожалуйста, попробуйте еще раз через две минуты.
-102 Такого ресурса не существует.