HLR-запрос#

Платформа обеспечивает параллельную обработку большого количества запросов без существенного увеличения времени исполнения каждого из них.
При выполнении большого числа последовательных HLR-запросов в одном потоке рекомендуется HTTP-соединение держать открытым, используя keep-alive.

Формат запроса#

  • Метод запроса: GET;

  • кодировка символов: UTF-8 (рекомендовано).

http://lk.rapporto.ru:9002/partnername?phone=79991234567

Ответ на HLR-запрос#

В течение установленного таймаута Платформа отвечает на запрос Партнера одним из HTTP-статусов.

Статус

Описание

200

ОК. Успешная обработка запроса. В HTTP Body платформа передает Партнеру данные абонента из HLR в формате XML.

400

Передан некорректный номер телефона (параметр phone).

403

Попытка подключения с недопустимого IP-адреса.

Если запрос был обработан, Платформа возвращает ответ в формате XML.

Примеры ответов на запрос#

<hlr>
    <msisdn>79012345678</msisdn>
    <state>1</state>
    <orn>МегаФон</orn>
</hlr>

Описание параметров ответа#

Параметр

Описание

msisdn

Номер абонента.

state

Состояние номера. Возможные значения:

  • – 1 — не определено;

  • 0 — не доступен;

  • 1 — доступен.

error_code

Цифровой код ошибки (если есть).

error

Текстовое описание ошибки (если есть).

orn

Оператор, которому принадлежит номер.

Описание кодов ошибок (параметр error_code)#

Код error_code

Описание error (передаётся в XML)

Подробное описание (не передаётся в XML)

0

Ошибка не определена

Ошибка не определена.

1

Абонент не существует

Некорректный номер абонента, либо телефон абонента был выключен на протяжении большого периода времени.

2

Неправильный формат номера

Неправильный формат номера абонента.

3

Абонент временно недоступен

Абонент находится вне зоны действия сети.

4

Превышен таймаут ожидания ответа

Превышен таймаут ожидания от оператора ответа на запрос.

5

Системная ошибка

При обработке запроса произошла системная ошибка на стороне оператора.

6

Отказ домашней сети

Запросы запрещены домашней сетью абонента.

7

Сбой домашней сети

Оборудование сети абонента работает нестабильно.

8

Запрет вызова

Вероятнее всего абонент находится в роуминге, а услуга приема SMS в роуминге отключена.

9

Услуга недоступна

Вероятнее всего у абонента отключена услуга приема SMS.