Регистрация
Подключиться
Я даю согласие на обработку персональных данных
HLR API (HTTPS,JSON,XML)
Запросы передаются на адрес: https://auth.terasms.ru/outbox/hlr/
JSON запрос: https://auth.terasms.ru/outbox/hlr/json/
XML запрос: https://auth.terasms.ru/outbox/hlr/xml/

Пример запроса:
https://auth.terasms.ru/outbox/hlr/?login=terasms&password=12345&target=79017654321

Возможные варианты реализации на языке программирования php:

1) для запроса информации по одному номеру (GET)

$api_uri = 'https://auth.terasms.ru/outbox/hlr/'; $query_array = array( 'login' => 'login', 'password' => 'password', 'target' => 'target' ); $get_string = http_build_query( $query_array ); $id = file_get_contents( $api_uri . '?' . $get_string); 2) для запроса информации по одному номеру (POST)

$api_uri = 'https://auth.terasms.ru/outbox/hlr/'; $query_array = array( 'login' => 'login', 'password' => 'password', 'target' => 'target' ); $context = stream_context_create(array( 'http' => array( 'method' => 'POST', 'content' =>http_build_query($query_array), 'timeout' => 10, ), )); $id = file_get_contents($api_uri, false, $context); 3) для запроса информации по нескольким номерам (POST)

$api_uri = 'https://auth.terasms.ru/outbox/hlr/'; $query_array = array( 'login' => 'login', 'password' => 'password', 'target' => 'target1,target2,target3' ); $context = stream_context_create(array( 'http' => array( 'method' => 'POST', 'content' => http_build_query($query_array), 'timeout' => 10, ), )); $ids = file_get_contents($api_uri, false, $context); Примеры ответов:

Ответ в формате XML:

<hlrlist> <hlr> <destination>79858691234</destination> <id>v1ofozgy9m7hs6jllmnq</id> <stat>DELIVRD</stat> <IMSI>250018555579718</IMSI> <err>0</err> <orn>MTS (Mobile TeleSystems)</orn> <pon>MTS (Mobile TeleSystems)</pon> <ron>MTS (Mobile TeleSystems)</ron> <mccmnc>25001</mccmnc> <rcn>Russian Federation</rcn> <onp>985</onp> <ocn>Russian Federation</ocn> <ocp>7</ocp> <is_ported>false</is_ported> <rnp>916</rnp> <rcp>7</rcp> <is_roaming>false</is_roaming> <pnp>79871200000</pnp> <pcn>Russian Federation</pcn> <pcp>7</pcp> </hlr> </hlrlist> Ответ в формате JSON:

[ { "destination":"79858691234", "id":"ikcr8of7erqhitzc45uf", "stat":"REJECTD", "IMSI":"", "err":"0", "orn":"", "pon":"", "ron":"", "mccmnc":"", "rcn":"", "onp":"", "ocn":"", "ocp":"", "is_ported":"false", "rnp":"", "rcp":"", "is_roaming":"false", "pnp":"", "pcn":"", "pcp":"" } ] Возвращаемые данные:

  • destination - возвращаемые данные
  • id - ид ответа
  • stat - статус ответа
  • IMSI
  • err - код ошибки
  • orn - Original network name
  • pon - Ported network name
  • ron - Roaming network name
  • MCCMNC
  • rcn - Roaming network code
  • onp - Original network prefix
  • ocn - Original country name
  • ocp - Original country prefix
  • is_ported - Был ли перенос номера от оператора к оператору
  • rnp - Roaming network prefix
  • rcp - Roaming country prefix
  • is_roaming - номер в роуминге
  • pcn - Ported network name
Возможные статусы ответа:

  • DELIVD - запрос успешно выполнен
  • UNDELIV - произошла ошибка
  • UNKNOWN - произошла неизвестная ошибка
  • REJECTED - такие запросы невозможны в эту сеть
  • EXPIRED - вышел срок жизни
  • DELETED - удалено из очереди обработки
  • ACCEPTED - принято в обработку
Коды ошибок

Основые:
  • 1 - номер адресата отсутствует в БД оператора (Абонент не обслуживается)
  • 27 и 6 - Адресат не может принять короткое текстовое сообщение, т.к. или выключен аппарат, или находится вне зоны действия сети
  • 13 - На телефоне установлен запрет на прием (по меньшей мере, входящих) вызовов и сообщений.
  • 11 - Абоненту запрещен прием коротких сообщений оператором его домашней сети
Дополнительные коды ошибок

  • 5 - Номер адресата имеется в БД оператора, но не зарегистрирован на коммутаторе, на который ссылается БД
  • 9 - Блокировка со стороны оператора (без уточнения)
  • 12 - Номер (оборудование) адресата недопустимо для обмена короткими текстовыми сообщениями
  • 21 - MSC оператора не поддерживеает функцию коротких сообщений действия сети
  • 31 - В момент доставки адресат был занят приемом или передачей другого короткого сообщения
  • 32 - Сбой на стороне мобильного устройства при приёме сообщения
  • 33 - Ошибка возникающая из-за переполнения очереди сообщений на стороне SMS-центра
  • 34 - Ошибка возникающая на коммуникационном оборудовании в момент проведения операции по доставке сообщения абоненту
  • 36 - Ошибка возникающая на уровне межсетевого протокола передачи сообщения из-за передачи данных не предусмотренные данным протоколом
  • 256 - У адресата отсутствует свободное место в памяти SIM-карты, на приемной стороне нужно удалить старые сообщения, чтобы освободить место для новых. Будут предприниматься попытки доставить сообщение позже
  • 257 - Сбой при приеме короткого сообщения телефоном или SIM-картой. Будут предприниматься попытки доставить сообщение позже
  • 258 - номер (оборудование) адресата недопустимо для обмена короткими текстовыми сообщениями
  • 260 - Сообщение не было доставлено адресату из-за большого количества данных (перегрузки) получаемые коммуникационным оборудованием оператора
  • 261 - Некорретный адрес отправителя.
  • 262 - Сообщение не было доставлено адресату из-за его отсутствия на зарегистрированном ранее коммуникационном оборудовании
  • 500 - Указывает на ошибки связанные с типом протокола
  • 502 - Ошибка говорит о том, что от оборудования конечной сети в установленный интервал времени ответа не получено. Обычно указывает на наличие временных или постоянных проблем на уровне взаимодействия двух сетей
  • 503 - Ошибка говорит о том, что от оборудования конечной сети в установленный интервал времени ответа не получено. Обычно указывает на наличие временных или постоянных проблем на уровне взаимодействия двух сетей
  • 504 - Данная ошибка возвращается со стороны оператора, когда оборудование оператора не возвращает какой-либо ответ в установленный срок
  • 507 - Ошибка произошла из-за отсутствия ряда необходимых параметров для доставки сообщения адресату
  • 511 - Запрошенная операция не может быть вызвана. Этот код выданный TCAP пользователя.
  • 1027 - Указывает, что абонент готов принять MAP диалог в режиме защиты, предусмотренном инициирующей стороной
  • 1028 - Указывает, что абонент не готов принять MAP диалог с режимом защиты, предусмотренным инициирующей стороной
  • 1030 - Диалоговое MAP было отклонено в связи с тем, что контекст приложения не поддерживается абонентом или диалог был прерван абонентом
  • 1031 - Указывает, что удаленный узел не был доступен через SCCP до открытия диалогового окна
  • 1152 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = no translation for an address of
  • 1153 - Специальный Номер, Ошибка говорит о том, что осуществлявшей запрос сети-партнеру не удалось транслировать адрес.
  • 1154 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = subsystemCongestion
  • 1155 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = subsystemFailure
  • 1156 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = unequippedUser
  • 1157 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = MTPfailure
  • 1158 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = networkCongestion
  • 1159 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = unqualified
  • 1163 - Указывает, что удаленный узел не был доступен через SCCP, SCCP UDTS-сообщение было возвращено со статусом Return Cause = SCCPfailure
  • 1281 - Сообщение было разорвано удаленным узлом по неопределенной причине
  • 1282 - Сообщение было разорвано удаленным узлом из-за загруженности на уровне МАР
  • 1283 - Сообщение было разорвано удаленным узлом по иной причине нежели загруженность на уровне МАР
  • 1536 - Сообщение было разорвано удаленным узлом из-за ошибки формата в TCAP (часть транзакций) на уровне стека протоколов SS7.
  • 1538 - Сообщение было разорвано удаленным узлом из-за загруженности на уровне TCAP
  • 1539 - Указывает, что ТСАР-ABORT сообщение было получено за счет технических работ на сетевом уровне.
  • 1540 - Указывает, что ТСАР-ABORT с параметром P-прерывания с «No Common Dialogue Portion».
  • 1541 - Указывает, что ТСАР-ABORT было получено по причине того, что MAP диалог не в соответствии с указанным контекстом приложения
  • 2048 - Указывает диалоговое время ожидания, но без вызова ТСАР TIME_OUT, как и в случае ошибки NO_RESPONSE.
  • 2051 - MSC, возвращаемый HLR не действителен (длина адреса составляет менее 5 цифр, адрес, начинающийся с цифры «0», TON/NPI не соответствует международному стандарту/e164)
  • 4096 - Ошибка, зафиксированная на уровне сигнала. Требуется дополнительное уточнение с оператором
  • 4100 - Отменено на уровне SMS центра
  • 4101 - Период валидности истёк
Регистрация
Подключиться
Я даю согласие на обработку персональных данных
Заказать просчет
It's totally free