| Управление шаблонами сообщенийДля управления шаблонами сообщений необходимо вызвать методом GET или POST соответствующий адрес с указанием требуемой команды
и параметров.
Для создания шаблона:
http://smscenter.primatel.ru/sys/templates.php?add=1&login=<login>&psw=<password>&name=<name>&msg=<msg>
Для изменения шаблона:
http://smscenter.primatel.ru/sys/templates.php?chg=1&login=<login>&psw=<password>&id=<id>
Для удаления шаблона:
http://smscenter.primatel.ru/sys/templates.php?del=1&login=<login>&psw=<password>&id=<id>
Для получения списка шаблонов:
http://smscenter.primatel.ru/sys/templates.php?get=1&login=<login>&psw=<password>
Серверу передаются следующие параметры:
| Параметр | Значение
|
|---|
| login | Логин Клиента.
|
|---|
| psw | Пароль Клиента (можно добавить или изменить на данной странице).
|
|---|
| name | Название шаблона.
|
|---|
| msg | Текст сообщения.
|
|---|
| format | Формат сообщения:
пустая строка – не задан.
sms – SMS-сообщение.
flash – Flash-SMS.
bin – Бинарное SMS.
push – Wap-push.
mms – MMS.
call – Звонок.
mail – E-mail.
viber – Viber.
|
|---|
| sender | Имя отправителя.
|
|---|
| fl[1] | Использовать для автоподписи.
|
|---|
В случае ошибки Сервер возвращает следующую строку:
- при fmt = 0:
ERROR = N (описание)
- при fmt = 1:
0,-N
- при fmt = 2:
<result>
<error>описание</error>
<error_code>N</error_code>
</result> |
- при fmt = 3:
{
"error": "описание",
"error_code": N
} |
N – номер ошибки, может принимать следующие значения:
| Значение | Описание
|
|---|
| 1 | Ошибка в параметрах.
|
|---|
| 2 | Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (если такой список был настроен Клиентом ранее).
|
|---|
| 3 | Запись не найдена.
|
|---|
| 4 | IP-адрес временно заблокирован.
|
|---|
| 5 | Ошибка сохранения или удаления.
|
|---|
| 9 | Попытка отправки более трех одинаковых запросов на действия с шаблонами.
Данная ошибка возникает также при попытке отправки пятнадцати и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).
|
|---|
В случае успешного запроса Сервер возвращает ответ в виде строки:
При создании шаблона:
- при fmt = 0: ID - <id>
- при fmt = 1: <id>
- при fmt = 2:
<template>
<id>id</id>
</template>
|
- при fmt = 3:
При изменении или удалении шаблона:
- при fmt = 0, 1: OK
- при fmt = 2:
<result>OK</result>
- при fmt = 3:
При запросе списка шаблонов сообщений:
- при fmt = 0:
id = <id>, name = <name>, format = <format>, sender = <sender>, flag = <flag>, message = <message>
... |
- при fmt = 1:
<id>,<name>,<format>,<sender>,<flag>,<message>
... |
- при fmt = 2:
<list>
<template>
<id>id</id>
<name>name</name>
<format>format</format>
<sender>sender</sender>
<flag>flag</flag>
<message>message</message>
</template>
...
</list> |
- при fmt = 3:
[{
"id": <id>,
"name": "<name>",
"format": "<format>",
"sender": "<sender>",
"flag": <flag>,
"message": "<message>"
},
...] |
Где:
<id> – идентификатор шаблона, назначенный системой автоматически.
<name> – название шаблона.
<format> – формат сообщения.
<sender> – имя отправителя.
<flag> – флаг для шаблона. Установка первого бита флага (fl[1]=1) назначает использование шаблона для автоподписи.
<message> – текст сообщения.
Сервер не принимает более трех одинаковых запросов на действия с шаблонами в течение минуты для снижения
нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.
|
Управление шаблонами сообщений