...
Code Block |
---|
error: Попытка отправки более одного одинакового запроса в течение минуты |
Запрос на отправку смс
Отправляется GET-запрос по адресу:
...
translite
транслитерация текста СМС с кириллицы на латиницу (не обязательный параметр). Для транслитерации данный параметр должен быть равен 1.
В случае успешной отправки смс
Возвращается ID SMS в plainText. Пример:
...
Code Block |
---|
1178440060,1178440061 |
Проверка статуса SMS
Отправляетя GET-запрос по адресу:
...
user – пользователь
pwd – пароль
smsid
ID SMS
В случае успешного запроса
В случае успешного запроса возращается статус SMS сообщения в plainText:
send
статус сообщения не получен.
not_deliver
сообщение не было доставлено. Конечный статус (не меняется со временем).
expired
абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный Статус (не меняется со временем).
deliver
сообщение доставлено. Конечный статус (не меняется со временем)
partly_deliver
сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.
Пример:
Code Block |
---|
deliver |
Проверка статуса SMS с подробной информацией
Отправляетя GET-запрос по адресу:
...
user – пользователь
pwd – пароль
smsid
ID SMS
detail
Запрос на детальную информацию по смс, всегда цифра 1
В случае успешного запроса
В случае успешного запроса возращается статус SMS сообщения в формате plainText. Строка является массивом, обработанной через php функцию serialize(). Для обратного перевода строки в массив, необходимо использовать php функцию unserialize():
...
id_sms
номер SMS сообщения, полученный в ответном XML-документа в процессе отправки SMS сообщения.
time_change_state
время изменения статуса.
state_sms
статус сообщения:
«send» - статус сообщения не получен. В этом случае передается пустой time_change_state.
«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).
«expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный Статус (не меняется со временем.
«deliver» - сообщение доставлено. Конечный статус (не меняется со временем)
«partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.
num_parts
Количество частей в СМС.
price
Цена за одну часть СМС.
Проверка баланса
Отправляется GET-запрос по адресу:
...
Code Block |
---|
https://clk.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&balance=1 |
Переменные: user – пользователь pwd – пароль * balance – параметр, определяющий вывод баланса (цифра 1)
В случае успешного запроса
В случае успешного запроса в plainText возвращается ваш текущий баланс и остаток по текущему пакету через запятую. Пример ответа:
Code Block |
---|
445.6 RUR Россия:361,МТС:1,Мегафон:1,Skylink:1,Yota:1,Байкалвестком:1,Уралсвязьинформ:1,Енисейтелеком:1,НСС:1,Мотив:1,Tele2:1,СМАРТС:1,Ростелеком:1,BeeLine:1,Остальные:1 |
Входящие СМС
Имеется возможность принимать входящие СМС, в том числе и с коротких номеров. Для подключения сервиса, использующего короткий номер, необходимо:
...
После обработки "входных данных" ваш скрипт должен ответить HTTP статусом 200 с текстом smsid=543 (Уникальный идентификатор СМС). В противном случае наша система будет пытаться доставить сообщение снова и снова (увеличивая интервал между попытками).
Ошибки возвращаемые платформой
В случае возникновения ошибки возращается текст ошибки в plainText. Возможные варианты:
...