Проверка на обхвата на таблицата за разпределение
Проверете дали северноамерикански номер съответства на префикс в таблицата за разпределение на 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 | Метаданни за съвпадащия префикс в таблицата за разпределение. Тези полета не посочват текущото физическо местоположение на абоната или текущия му оператор след пренасяне на номера. |
Грешки
Проверявайте полето JSON status.code, вместо да разчитате само на HTTP 200. API код 404 със съобщение Not part of NANPA означава, че не е намерен съвпадащ префикс в таблицата, използвана от услугата; това не е окончателно заключение на орган по номерацията с глобална валидност. API код 500 се използва при невалиден брой цифри или липсващ номер.
Цена и следващи стъпки
Прегледаният обработчик прави локална заявка към таблицата за разпределение и не съдържа операции за приспадане на суми от акаунта или за външни справки. Този обработчик не начислява такса за справката. Използвайте търсенето на налични номера за намиране на налични номера, които могат да бъдат поръчани. Справката за име, справката за маршрутизация или поръчката на номер е отделна операция със собствена цена според тарифите на акаунта.