Програмери

GET/v3/nanpacheck/{number}

Проверите покривеност северноамеричких бројева табелом доделе

Упоредите број са табелом доделе, без тумачења резултата као провере претплатника или доступности броја.

На овој страници
  1. Проверите покривеност табелом доделе
  2. Захтев
  3. Одговор
  4. Грешке
  5. Трошкови и следећи кораци

Проверите покривеност табелом доделе

Проверите да ли се северноамерички број подудара са префиксом у MultiTEL-овој табели доделе и преузмите повезане податке о граду, савезној држави и земљи. Ово је претрага табеле префикса. Она не потврђује да је претплатник активан, да је број додељен, да припада вашем налогу нити да можете да га наручите.

Захтев

Користите свој омогућени API налог и дозвољену изворну IP адресу. Пример користи акредитиве за HTTP Basic из променљивих окружења и измишљени број. Тело захтева није потребно.

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

Препоручује се једанаестоцифрени северноамерички број који почиње цифром 1. Код за обраду уклања све знакове који нису цифре и додаје 1 на почетак десетоцифреног уноса. Уноси са другим бројем цифара се одбијају. Ова нормализација не проверава сва правила северноамеричког плана нумерације, па успешно подударање у табели није свеобухватна провера исправности броја.

Одговор

Вредности поља служе само као илустрација; ово није резултат претраге актуелне табеле доделе.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
Поља подударања у табели доделе
ПољеЗначење
numberНормализовани унос који садржи само цифре.
npanxxСачувани префикс који се подудара са уносом. Код за обраду даје предност седмоцифреном префиксу земље/подручја/централе, а ако нема таквог подударања, може да употреби четвороцифрени префикс земље/подручја; немојте претпостављати да ово поље увек идентификује целу централу.
city, state, countryМетаподаци за префикс доделе који се подудара са уносом. Ова поља не идентификују тренутну физичку локацију претплатника нити тренутног оператера након преноса броја.

Грешке

Прочитајте поље status.code у JSON одговору уместо да се ослањате само на HTTP 200. API код 404 са поруком Not part of NANPA значи да није пронађено подударање ни са једним префиксом у табели коју услуга користи; то није коначна оцена надлежног тела за нумерацију на светском нивоу. API код 500 користи се када број цифара није исправан или број недостаје.

Трошкови и следећи кораци

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