| Получение информации об оператореДля получения информации об операторе абонента необходимо вызвать методом GET или POST адрес:
http://smscenter.primatel.ru/sys/info.php?get_operator=1&login=<login>&psw=<password>&phone=<phone>
Описание параметров, передаваемых Серверу:
| Параметр | Значение
|
|---|
| login | Логин Клиента.
|
|---|
| psw | Пароль Клиента (можно добавить или изменить на данной странице).
|
|---|
| phone | Номер телефона абонента или список номеров через запятую.
|
|---|
В случае ошибки Сервер возвращает следующую строку:
- 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 | Попытка отправки более трех одинаковых запросов или любых 100 запросов на получение
информации об операторе абонента в течение минуты.
Данная ошибка возникает также при попытке отправки пятнадцати и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).
|
|---|
При успешном запросе Сервер возвращает ответ в виде строки или списка строк при множественном запросе (в этом случае в ответ
Сервера добавляется параметр "phone"):
- при fmt = 0: country = <country>, operator = <operator>, region = <region>, mcc = <mcc>, mnc = <mnc>, tz = <tz>
- при fmt = 1: <country>,<operator>,<region>,<mcc>,<mnc>,<tz>
- при fmt = 2:
<info>
<country>country</country>
<operator>operator</operator>
<region>region</region>
<mcc>mcc</mcc>
<mnc>mnc</mnc>
<tz>tz</tz>
</info>
|
При множественном запросе конструкции <info> заключаются в тег <list>.
- при fmt = 3:
{
"country": "<country>",
"operator": "<operator>",
"region": "<region>",
"mcc": "<mcc>",
"mnc": "<mnc>",
"tz": "<tz>"
} |
Где:
<phone> – номер телефона абонента.
<country> – название страны регистрации номера абонента.
<operator> – мобильный оператор абонента.
<region> – регион регистрации номера абонента.
<mcc> – числовой код страны абонента.
<mnc> – числовой код оператора абонента.
<tz> – часовой пояс региона регистрации номера абонента.
Пример:
Получение информации об операторе абонента с номером "79999999999":
http://smscenter.primatel.ru/sys/info.php?get_operator=1&login=alex&psw=123&phone=79999999999
Сервер не принимает более трех одинаковых запросов в течение минуты на получение информации
об операторе абонента для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.
Сервер также блокирует отправку более 100 запросов в течение минуты на получение данных об операторе для снижения
нагрузки на базу данных.
|
Получение информации об операторе