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. Это число является референсом, с помощью которого Вы можете в дальнейшем проверить статус доставки сообщения.