HLR API#
Сервис HLR может предоставить по запросу данные обо всех абонентах, зарегистрированных в сети оператора сотовой связи. Например, информацию о подписке, активных услугах, состоянии счета и текущем местоположении абонента.
HLR API v.3.0 предназначен для передачи системой Партнера HLR-запросов Сервис-провайдеру с целью получения информации о состоянии номера абонента.
Функциональные возможности#
HLR API обеспечивает возможность передачи Партнеру следующей информации о номере абонента:
статусе абонента (доступен или недоступен);
наименовании оператора, которому принадлежит номер телефона абонента;
коде ошибки с расшифровкой (в случае, если абонент недоступен).
Защита интерфейса обеспечивается по IP-адресам, либо настройкой VPN-соединения между системами Сервис-провайдера и Партнером.
Возможна настройка интерфейса в режиме тестирования.
Взаимодействие с платформой#
Взаимодействие по HTTP-протоколу между Сервис-провайдером и системой Партнера осуществляется при помощи GET-запросов.
Сервис-провайдер принимает от Партнера GET-запрос, обрабатывает его, проверяет номер абонента из запроса Партнера на принадлежность его к номерной ёмкости операторов РФ.
При успешной обработке запроса Платформа возвращает Партнёру XML с ответом. В таком случае HLR-запрос будет тарифицирован.
Если номер некорректный (например 77027077070, Казахстан) — Партнеру будет возвращена ошибка 400, HLR-запрос отправлен не будет. Если на запрос Партнера была возвращена ошибка HTTP 400 или 403 — запрос тарифицироваться не будет.