Определение оператора РФ по номеру абонента (network lookup)

Доступ к информации осуществляется по протоколу HTTP. Можно применять как GET, так и POST запросы.

Описание обычного GET/POST-запроса

Для получения информации по одному номеру запросы отправляются на адрес: https://auth.terasms.ru/outbox/network_lookup/

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

Для получения информации по нескольким номерам абонентов используется адрес: https://auth.terasms.ru/outbox/bulk_network_lookup/

Максимальное количество номеров в одном запросе: 100

При превышении количества номеров, передаваемых за один запрос, система вернет код ошибки -100

Пример запроса: https://auth.terasms.ru/outbox/bulk_network_lookup/?login=terasms&password=12345&targets=780012345,780054321

Формирование запроса в формате json:

						> POST auth.terasms.ru/outbox/bulk_network_lookup/json

{
 "login": "login",
 "password": "secret",
 "targets": ["71234567890", "71234567890"]
}
					 

Формирование запроса в формате xml:

> POST auth.terasms.ru/outbox/bulk_network_lookup/xml

<?xml version="1.0"?>
<request>
    <login>login</login>
    <password>password</password>
    <targets>
        <target>71234567890</target>
        <target>71234567891</target>
    </targets>
</request>					

Пример ответа:

{
 mnp_data:  {
   number:71234567890,
   owner_id:"mTELE2",
   owner_name:"Т2 Мобайл ООО",
   region_code:50,
   region_name:"Липецкая область",
   utc_offset:3,
   mnc:20,
   port_date:"2015-02-02T05:00:35+03:00",
   t_c_id:8231,
   t_c_alias:"tele2",
   time_in_network_region:"2017-07-07 19:02:35",
  },
  rs_data:  {
   from:5000000,
   to:5499999,
   owner_id:"mMEGAFON",
   mnc:2,
   region_code:50,
   region_name:"Липецкая область",
   utc_offset:3,
   time_in_network_region:"2017-07-07 19:02:35",
   t_c_id:8230,
  },
  process_in_sec:0.00001
}
					

Пример ответа при запросе информации по нескольким номерам:

{
   "79XXXXXXXXX":{
      "mnp_data":{
        ...
      },
      "rs_data":{
         ...
      },
      "process_in_sec":"0.00170"
   },
   "79XXXXXXXXX":{
      "rs_data":{
         ...
      },
      "process_in_sec":"0.00277"
   },
   "79XXXXXXXXX":{
      "rs_data":{
         ...
      },
      "process_in_sec":"0.00407"
   }
}
					

Структура ответа

mnp_data - если абонент был портирован, то в этом массиве будет следующая информация:

number: 9205203244
owner_id: mTELE2
owner_name: "Т2 Мобайл" ООО
region_code: 50
region_name: Липецкая область
utc_offset: 3
mnc: 20
port_date: 2014-02-02T05:00:35+03:00
time_in_network_region: 2017-07-10 16:51:01

rs_data - данные россвязи по номеру абонента:

from: 5000000
to: 5499999
owner_id: mMEGAFON
mnc: 2
region_code: 50
region_name: Липецкая область
utc_offset: 3
time_in_network_region: 2017-07-10 16:51:01

t_c_id - идентификатор оператора на стороне terasms. Список идентификаторов :

'mts' => '8471',
'beeline' => '8472',
'megafon' => '8230',
'tele2' => '8231',
'smarts' => '10939',
'motiv' => '10616',
'yota' => '12778',
'russia' => '89'