Потърсете информация за маршрутизиране

Заявете информация за маршрутизиране за северноамерикански телефонен номер. Използвайте я за тълкуване на наличните данни за маршрутизирането и оператора, а не като доказателство за самоличността на абоната, собствеността върху номера, възможността за свързване с него или наличността му за покупка. Справката може да доведе до начисляване на такса по акаунта ви.

Заявка

Използвайте активирания си 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 не потвърждава, че справката е използваема. Проверете валидността на полетата, необходими на приложението ви, съпоставете неясните такси с отчетите за таксуване по акаунта и се свържете с поддръжката при непълни резултати.

В прегледаната реализация обработката на безплатни номера се различава според дължината на входните данни. Предпочитайте пълния номер в международен формат, изписан само с цифри, и потвърдете с поддръжката дали се поддържат необходимите ви безплатни номера. Не повтаряйте автоматично справката при неправилно форматиран или непълен резултат и не разчитайте на справка за маршрутизиране, за да решите, че обаждането до даден номер е безопасно или разрешено.