Потражите податке о рутирању

Затражите податке о рутирању за северноамерички телефонски број. Користите их за тумачење доступних података о рутирању и оператеру, а не као доказ идентитета претплатника, власништва, доступности броја за успостављање позива или могућности његове куповине. Упит може довести до наплате са вашег налога.

Захтев

Користите свој активирани API налог и изворну IP адресу која је за њега дозвољена. Наведите цео број у облику цифара, укључујући позивни број земље 1. Пример користи променљиве окружења и измишљени број. Обрађивач не нормализује интерпункцијске знакове; проверите исправност уноса пре слања.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

Одговор

Приказана су само одабрана поља као пример; њихова доступност зависи од извора и врсте броја.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Стандардни упит претвара називе враћених поља у мала слова. У зависности од извора, могу бити присутна поља за оператера, тарифни центар, локацију и јурисдикцију. Одговор није потпун запис о претплатнику са фиксним скупом поља. Ознака local може бити бројчана вредност 1 или знаковни низ 0. Обрађивач израчунава ported поређењем враћеног броја за рутирање са наведеним телефонским бројем; немојте то тумачити као проверену потпуну историју преноса броја.

Цена и поновни покушаји

Прегледани обрађивач задужује налог за $0.00025 када достигне завршни ток обраде и забележи упит. Враћена цена обично је знаковни низ који садржи знак долара, а не само бројчани износ. Кључ идемпотентности није доступан. Понављање захтева може довести до нове наплате.

За припејд налоге код проверава да ли стање износи најмање 0.00025. Порука о недовољном стању тренутно помиње $5, што не одговара том прагу. Тумачите овај неуспех као одбијање због стања на налогу и проверите средства на налогу пре поновног покушаја.

Неуспеси и непотпун успех

Проверите и HTTP статус и status.code/status.msg у JSON одговору. Празан резултат стандардног упита враћа API код 404. API код 403 може указивати на недовољно стање на припејд налогу.

Један од тренутних токова обраде грешака за бесплатне бројеве и даље може задужити налог за износ упита и пријавити API код 200 без корисних поља за рутирање; податак о цени може бити непотпун. Сам код 200 стога не потврђује да је резултат упита употребљив. Проверите исправност поља потребних вашој апликацији, упоредите спорне наплате са евиденцијом наплате на налогу и обратите се подршци у случају непотпуних резултата.

У прегледаној имплементацији обрада бесплатних бројева разликује се у зависности од дужине уноса. Дајте предност целом броју у међународном формату, наведеном само цифрама, и проверите са подршком да ли су подржани бесплатни бројеви који су вам потребни. Немојте аутоматски понављати упит ако је резултат неправилно обликован или непотпун и немојте се ослањати на упит о рутирању да бисте закључили да је позивање броја безбедно или дозвољено.