| Подключение выделенных номеров для приема сообщенийВы можете через специальные команды API получать список свободных выделенных номеров для приема SMS-сообщений
и подключать любой номер к своему логину, оплачивая стоимость за остаток дней в текущем месяце. При подключении
выделенного номера вы автоматически соглашаетесь с правилами использования таких номеров.
Для получения списка доступных выделенных номеров необходимо вызвать методом GET или POST следующий адрес:
http://my.smsc.dp.ua/sys/receive_phones.php?get=1&login=<login>&psw=<password>
Для подключения выделенного номера необходимо вызвать методом GET или POST адрес:
http://my.smsc.dp.ua/sys/receive_phones.php?buy=1&login=<login>&psw=<password>&phone=<phone>
Для изменения признака продления выделенного номера на следующий месяц необходимо вызвать методом GET или POST адрес:
http://my.smsc.dp.ua/sys/receive_phones.php?chg=1&login=<login>&psw=<password>&phone=<phone>&noprolong=<noprolong>
Описание параметров, передаваемых Серверу:
| Параметр | Значение
|
|---|
| login | Логин Клиента.
|
|---|
| psw | Пароль Клиента (можно добавить или изменить на данной странице).
|
|---|
| phone | Подключаемый номер.
|
|---|
| noprolong | Признак продления выделенного номера на следующий месяц. Данный параметр также возможно указывать при подключении
номера в команде buy.
0 (по умолчанию) – включить автоматическое продление номера.
1 – отключить автоматическое продление номера.
|
|---|
В случае ошибки Сервер возвращает следующую строку:
- 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-адрес временно заблокирован.
|
|---|
| 9 | Попытка отправки более двух одинаковых запросов на получение списка доступных для аренды номеров или подключение номера,
либо изменение свойств выделенного номера в течение минуты.
Данная ошибка возникает также при попытке отправки более 15 любых запросов одновременно.
|
|---|
В случае успешного запроса Сервер возвращает ответ в виде строки.
Для получения списка доступных номеров:
- при fmt = 0:
phone = <phone>, type = <type>, cost = <cost>, current_cost = <current_cost>, info = <info>
... |
- при fmt = 1:
<phone>,<type>,<cost>,<current_cost>,<info>
... |
- при fmt = 2:
<list>
<receive_phone>
<phone>phone</phone>
<type>type</type>
<cost>cost</cost>
<current_cost>current_cost</current_cost>
<info>info</info>
</receive_phone>
...
</list>
|
- при fmt = 3:
[{
"phone": "<phone>",
"type": <type>,
"cost": "<cost>",
"current_cost": "<current_cost>"
"info": "<info>"
},
...] |
Где:
<phone> – номер телефона.
<type> – тип номера: 1,4 – выделенный виртуальный номер, 2 – номер на услуге SIM-хостинга.
<cost> – стоимость аренды номера за полный месяц.
<current_cost> – стоимость аренды номера за остаток дней до конца текущего месяца.
<info> – название оператора и поддерживаемые типы уведомлений.
Для аренды номера:
- при fmt = 0: cost = <cost>
- при fmt = 1: <cost>
- при fmt = 2:
<phone>
<cost>cost</cost>
</phone>
|
- при fmt = 3:
Где:
<cost> – сумма, списанная со счета Клиента за аренду номера.
Для изменения признака продления номера:
- при fmt = 0,1: OK
- при fmt = 2:
<result>OK</result>
- при fmt = 3:
Примеры:
Получение списка свободных номеров для аренды:
http://my.smsc.dp.ua/sys/receive_phones.php?get=1&login=alex&psw=123
Подключение номера "79999999999":
http://my.smsc.dp.ua/sys/receive_phones.php?buy=1&login=alex&psw=123&phone=79999999999
Отключение возможности продления выделенного номера "79999999999" на следующий месяц:
http://my.smsc.dp.ua/sys/receive_phones.php?chg=1&login=alex&psw=123&phone=79999999999&noprolong=1
Сервер не принимает более двух одинаковых запросов в течение минуты на получение списка свободных
для аренды номеров или подключение номера, либо изменение свойств выделенного номера для снижения нагрузки и защиты
от ошибок и зацикливаний в программе на стороне Клиента.
|
Подключение выделенных номеров для приема сообщений