Перевірка охоплення таблиці розподілу номерного ресурсу
Перевірте, чи відповідає північноамериканський номер префіксу в таблиці розподілу номерного ресурсу 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 використовується, якщо кількість цифр неприпустима або номер відсутній.
Вартість і подальші дії
Перевірений обробник виконує запит до локальної таблиці розподілу номерного ресурсу й не містить ані списання коштів з облікового запису, ані зовнішнього пошуку. Цей обробник не стягує плату за пошук. Використовуйте пошук доступних номерів для пошуку номерів, доступних для замовлення. Пошук імені, пошук даних маршрутизації або замовлення номера — це окрема операція з власними тарифами для облікового запису.