fastsms.pro HTTP API - отправка сообщения
Отправка сообщения.
Для отправки сообщений используется скрипт:
http://api.fastsms.pro/send.php
Пример отправки сообщения методом GET:
http://api.fastsms.pro/send.php?username=test&password=098f6bcd46
&sender=fastSms&numbers=79993330000&message=ТЕСТ
Обязательные параметры: | |
---|---|
username | ваше имя пользователя на сайте fastsms.pro |
password | ваш пароль на сайте в md5 |
sender | имя отправителя SMS. Максимальная длина значения – 16 символов для цифровых значений и 11, если Вы используете символы. Диапазон возможных значений a-z, A-Z, 0-9. Если Вы хотите, чтобы получатель смог ответить на Ваше сообщение, и ответ пришел на ваш мобильный телефон, то укажите его в качестве имени отправителя в международном формате, не используя знак «+», например: 79993330000 |
numbers | номера абонентов, разделенные запятой. Максимальное количество номеров в одном обращении - 15000. |
message | Ваше сообщение в кодировке UTF-8, максимальная длина не ограничена. Кодировка будет распознана автоматически. Размер одного сообщения составляет: Транслит: - 160 символов - 152 символа, если длина сообщения превышает 160 символов Другие языки: - 70 символов в кириллице или включающем символы не из ASCII - 66 символов, если длина сообщения превышает 70 символов |
Дополнительные параметры: | |
---|---|
valid | срок валидности сообщения в минутах. По умолчанию – 3 суток. Максимум – 7 суток. |
type | тип сообщения: 1-обычное SMS (по умолчанию), 2 – флэш SMS, 4 – кодировать в интернациональном формате. |
dlr | если необходим отчет о доставке – нужно установить это значение в 1. При этом имейте ввиду, сообщения отправляются оператору пакетами по 100 номеров (или меньше) в каждом. Поэтому, если количество адресатов превышает 100, в ответ Вы получите только референс последнего пакета. Итак, если Вы хотите получать корректные отчеты о доставке - отправляйте сообщения пакетами до 100 адресатов одновременно. |
parcelName | имя рассылки (до 50 символов). |
testing | установите этой переменной значение 1 в тестовом режиме. Отправка сообщений происходить не будет. |
when | планирование отправки. Подробнее смотрите планирование отправки. |
to_world | Преобразование номеров в международный фомат. В качестве значения указывайте код страны, например "RU" или "UA". |
unsunscribe | Предложить получателям отписаться от рассылок. |
useDirect | Использование прямых и непрямых подключений |
Возможные ошибки: | |
---|---|
ERROR:100 | неверный логин/пароль |
ERROR:200 | низкий баланс |
ERROR:300 | ошибка в сообщении |
ERROR:301 | пустое сообщение |
ERROR:302 | сообщение содержит ругательства |
ERROR:308 | слишком длинное сообщение |
ERROR:400 | аккаунт заблокирован |
ERROR:401 | другие причины блокировки |
ERROR:402 | причина блокировки - спам |
ERROR:500 | ошибка в номере |
ERROR:501 | пустой номер |
ERROR:502 | номер содержит недопустимые символы |
ERROR:504 | неизвестный код страны |
ERROR:508 | невозможно определить цену сообщения на данный номер |
ERROR:600 | ошибка в имени отправителя |
ERROR:601 | имя отправителя не может быть пустым |
ERROR:602 | имя отправителя распознано как спам |
ERROR:604 | имя отправителя должно содержать только латинские буквы или цифры |
ERROR:608 | имя отправителя должно содержать максимум 11 символов |
ERROR:616 | имя отправителя должно содержать максимум 16 цифр |
ERROR:632 | имя отправителя должно содержать не менее 3 символов |
ERROR:700 | неверный тип сообщения |
ERROR:900 | неверный IP-адрес |
ERROR:999 | количество адресатов больше 15000 |
Верный ответ должен содержать цифровое значение в диапазоне BIGINT, например: 100000051. Это число является референсом, с помощью которого Вы можете в дальнейшем проверить статус доставки сообщения.