Пошук інформації про маршрутизацію

Запитайте інформацію про маршрутизацію для північноамериканського телефонного номера. Використовуйте її для тлумачення доступних даних про маршрутизацію й оператора, а не як підтвердження особи абонента, права власності на номер, можливості зв’язатися з ним або доступності номера для придбання. За пошук з вашого рахунку може бути списано кошти.

Запит

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

У перевіреній реалізації обробка номерів, дзвінки на які безкоштовні для абонента, відрізняється залежно від довжини вхідних даних. Віддавайте перевагу повному номеру в міжнародному форматі, записаному лише цифрами, і уточнюйте у служби підтримки, чи підтримуються потрібні вам категорії таких номерів. Не повторюйте запит автоматично після отримання некоректно сформованого або неповного результату й не покладайтеся на пошук інформації про маршрутизацію, щоб вирішити, чи безпечно телефонувати на номер і чи маєте ви на це дозвіл.