Видимо, у вас отключен javascrip. Пожалуйста, включите его для полной функциональности сайта.

Документация (API)

Все запросы отправляются по адресу http://sms.payler.com/

Получить данные о пользователе по логину и паролю

authorize api/authorize (GET)

Параметры запроса

login Логин пользователя
password Пароль пользователя

Положительный ответ

{
"status": "OK",
"user": {
"id": int,
"login": string,
"password": string,
"authToken": string,
"status": string,
"name": string,
"senderName": string,
"updatedAt": date,
"createdAt": date
},
"numberErr": 202
}

Ошибки

{
"status": "ERROR",
"err": "Login is bad",
"numberErr": 401
}
пользователя с таким логином нет
{
"status": "ERROR",
"err": "Password is bad",
"numberErr": 400
}
неверный пароль

Отправить sms-сообщение

sendSMS api/sendSMS (POST)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя
phoneTo номер телефона получателя
формат: +(кодстраны)(DEFкод)(номер_телефона)
пример: +79630151111 или 79630151111,
также в данный параметр можно ввести список номеров телефонов через запятую
message текст сообщения
senderName имя отправителя (необязательный параметр: если этот параметр не указан, то имя отправителя будет по умолчанию для данного аккаунта)

Положительный ответ

{
"status": "OK",
"sms": {
"msisdn": string,
"id": string,
"status": int
},
"numberErr": 200
}
при отправке на один номер
{
"status": "OK",
"sms": [
{
"msisdn": "+79XXXXXXXXX",
"id": "575475953",
"status": 0
},
{
"msisdn": "+79XXXXXXXXX",
"id": "575475957",
"status": 0
}
],
"numberErr": 200
}
при отправке на несколько номеров

Ошибки

{
"status": "ERROR",
"err": " Некорректно введен номер телефона ",
“numberErr”: 403
}
некорректно введен номер телефона
{
"status": "ERROR",
"err": " Недостаточно средств на счете ",
"numberErr": 403
}
недостаточно средств на счете

Узнать статус sms-сообщения

statusSMS api/statusSMS (GET)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя
idSMS идентификатор sms-сообщения

Положительный ответ

{
"status": "OK",
"sms": {
"idSMS": string,
"pnoneNumber": string,
"status": int
},
"numberErr": 200
}

Возможные статусы доставки

Статус Описание Тип
0 Добавлена в очередь/в очереди промежуточный
12 Доставлено конечный
17 Неизвестный статус конечный
18 Отказ в передаче конечный
13 Просрочено конечный
15 Не доставлено конечный
255 Недействительно конечный

Тип “промежуточный” означает, что статус СМС не принял окончательное значение и точно изменится по факту действия с сообщением.

Если телефон абонента выключен и сообщение не удается доставить, максимальное время попытки отправки сообщения составляет до 3-х дней. По истечению данного срока сообщение принимает статус 13 (Просрочено).

Узнать баланс аккаунта

getBalance /api/getBalance (GET)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя

Если "blocking": true, — счет заблокирован.

Определение оператора и страны по номеру телефона

Info api/def/info(GET)

Параметры запроса

phone номер телефона

Получение списка всех отправленных sms-сообщений

listOperationsSMS /api/listOperationsSMS (GET)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя

Положительный ответ

{
"idSMS": XXXXXXX,
"phoneNumber": "+79XXXXXXXXX",
"date": "2016-12-01T09:49:20.040Z",
"status": 12,
"price": 1.2
}

Запрос статуса абонентского номера

sendHLR api/sendHLR (POST)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя
phone номер телефона

Положительный ответ

{
"status": "OK",
"hlrID": 54,
"numberErr": 200
}

Ошибки

{
"status": "ERROR",
"error": "invalid number",
"error_code": 7,
"numberErr": 200
}
некорректно введен номер телефона
{
"status": "ERROR",
"err": "Неправильный формат номера. Номер телефона должен начинаться со знака +, дальше код страны в международном формате(Россия +7)"
}
некорректный формат номера телефона
{
"status": "ERROR",
"err": " Недостаточно средств на счете ",
"numberErr": 403
}
недостаточно средств

Массовый запрос статусов абонентских номеров

sendHLRs api/sendHLRs (POST)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя
phone номера телефонов для проверки статусов через запятую, пример: +79630151111,+79191901020,…

Положительный ответ

{
"status": "OK",
"hlrID": 54,
"numberErr": 200
}

Ошибки

{
"status": "ERROR",
"error": "invalid number",
"error_code": 7,
"numberErr": 200
}
некорректно введен номер телефона
{
"status": "ERROR",
"err": "Неправильный формат номера. Номер телефона должен начинаться со знака +, далее код страны в международном формате(Россия +7)"
}
некорректный формат номера телефона
{
"status": "ERROR",
"err": " Недостаточно средств на счете ",
"numberErr": 403
}
недостаточно средств

Узнать статус sms-сообщений/сообщений

statusHLR api/statusHLR (GET)

Параметры запроса

id идентификатор пользователя
authToken токен авторизации пользователя
idHLR идентификатор запроса статуса телефонного номера

Пример запроса

GET sms.payler.com\api\statusHLR?id=X&authToken=XXX&idHLR=88

Положительный ответ

{
"status": "OK",
"hlr": [
{
"phoneNumber": "+79191901020",
"status": 1
},
{
"phoneNumber": "192925787",
"status": 22
}
]
}

Возможные статусы HLR

Статус Описание Тип
-1 Добавлена в очередь/в очереди промежуточный
1 В сети конечный
3 Не удалось проверить статус конечный
20 Выключен (недоступен) конечный
22 Номер не найден или не корректно был введен конечный
23 Запрещена проверка конечный
25 Заблокирован конечный

Тип “промежуточный” означает, что статус не принял окончательное значение и точно изменится по факту действия с сообщением.

Отправить sms-сообщение на email

SMTP (Email2SMS)

Отправка SMS-сообщений через sms.payler-шлюз платформы осуществляется посредством создания и последующей передачи клиентом сообщений электронной почты (e-mail) на сервисный адрес платформы:

email2sms@sms.payler.com
Тема письма(Subject): id,authToken,phone1,phone2,phone3,…
Тело письма: Текст передаваемого сообщения
Кому(To):email2sms@sms.payler.com
Тема письма(Subject): 2,XXXXXXXXXXX,+79191901020,+79803040134,+79192925787
Тело письма(Body): Тестовое сообщение

Все параметры, указанные в теме письма (Subject), должны быть без лишних пробелов!