Vyhledání informací o směrování

Vyžádejte si informace o směrování severoamerického telefonního čísla. Používejte je k interpretaci dostupných údajů o směrování a operátorovi, nikoli jako důkaz totožnosti účastníka, vlastnictví čísla, jeho dosažitelnosti nebo dostupnosti ke koupi. Za vyhledání může být z vašeho účtu stržen poplatek.

Požadavek

Použijte svůj aktivovaný účet API a jeho povolenou zdrojovou IP adresu. Zadejte celé číslo pouze číslicemi včetně předvolby země 1. Příklad používá proměnné prostředí a smyšlené číslo. Obslužný kód nenormalizuje interpunkční znaky; před odesláním ověřte platnost vstupu.

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

Odpověď

Jsou uvedena pouze vybraná pole pro ilustraci; jejich dostupnost závisí na zdroji a typu čísla.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Standardní vyhledávání převádí názvy vrácených polí na malá písmena. V závislosti na zdroji mohou být přítomna pole s údaji o operátorovi, tarifní oblasti, poloze a jurisdikci. Odpověď nepředstavuje úplný záznam o účastníkovi s pevně danou strukturou. Příznak local může mít číselnou hodnotu 1 nebo řetězcovou hodnotu 0. Obslužný kód vypočítává ported porovnáním vráceného směrovacího čísla se zadaným telefonním číslem; nepovažujte tuto hodnotu za ověřenou úplnou historii přenosů čísla.

Cena a opakování požadavků

Prověřený obslužný kód odečte z účtu $0.00025, když dosáhne větve dokončení a zaznamená vyhledání. Vrácená cena má obvykle podobu řetězce obsahujícího znak dolaru, nikoli samotné číselné částky. Klíč idempotence není k dispozici. Opakování požadavku může vést k dalšímu poplatku.

U předplacených účtů kód kontroluje, zda zůstatek dosahuje alespoň 0.00025. Zpráva o nedostatečném zůstatku nyní uvádí $5, což této hranici neodpovídá. Chápejte toto selhání jako odmítnutí kvůli zůstatku a před opakováním požadavku ověřte dostupné prostředky na účtu.

Selhání a neúplné úspěšné výsledky

Kontrolujte jak stav HTTP, tak hodnoty status.code/status.msg ve formátu JSON. Prázdný výsledek standardního vyhledávání vrací kód API 404. Kód API 403 může znamenat nedostatečný zůstatek na předplaceném účtu.

Jedna ze současných chybových větví pro bezplatná čísla může přesto odečíst částku za vyhledání a vrátit kód API 200 bez použitelných polí s údaji o směrování; údaj o ceně může být neúplný. Samotný kód 200 tedy nepotvrzuje, že vyhledání poskytlo použitelný výsledek. Ověřte pole, která vaše aplikace potřebuje, porovnejte nejasné poplatky s fakturačními záznamy účtu a v případě neúplných výsledků kontaktujte podporu.

V prověřené implementaci se zpracování bezplatných čísel liší podle délky vstupu. Upřednostňujte úplný mezinárodní zápis pouze číslicemi a u podpory si ověřte požadované pokrytí bezplatných čísel. Při nesprávně strukturovaném nebo neúplném výsledku požadavek automaticky neopakujte a nespoléhejte na vyhledání směrování při rozhodování, zda je volání na dané číslo bezpečné nebo povolené.