Определение оператора РФ по номеру абонента (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'