Hämta routningsinformation

Begär routningsinformation för ett nordamerikanskt telefonnummer. Använd informationen för att tolka tillgängliga routnings- och operatörsdata, inte som bevis på abonnentens identitet, äganderätt, nåbarhet eller att numret går att köpa. En uppslagning kan medföra en debitering på ditt konto.

Begäran

Använd ditt aktiverade API-konto och dess tillåtna käll-IP-adress. Ange hela numret som siffror, inklusive landskod 1. Exemplet använder miljövariabler och ett fiktivt nummer. Hanteraren normaliserar inte skiljetecken; validera indata innan du skickar begäran.

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

Svar

Endast ett urval av fält visas som exempel; tillgängligheten beror på källan och nummertypen.

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

Standarduppslagningen omvandlar de returnerade fältnamnen till gemener. Fält för operatör, taxeområde, plats och jurisdiktion kan finnas beroende på källan. Svaret är inte en fast, fullständig abonnentpost. Flaggan local kan vara talet 1 eller strängen 0. Hanteraren beräknar ported genom att jämföra det returnerade routningsnumret med det angivna telefonnumret; tolka inte detta som en verifierad, fullständig porteringshistorik.

Pris och nya försök

Den granskade hanteraren debiterar kontot med $0.00025 när den når sitt avslutande kodflöde och registrerar uppslagningen. Den returnerade kostnaden anges normalt som en sträng som innehåller dollartecknet, snarare än enbart ett numeriskt belopp. Ingen idempotensnyckel tillhandahålls. Om en begäran upprepas kan det leda till ytterligare en debitering.

För förbetalda konton kontrollerar koden att saldot är minst 0.00025. Meddelandet om otillräckligt saldo nämner för närvarande $5, vilket inte stämmer överens med den gränsen. Tolka felet som att begäran avvisats på grund av saldot och kontrollera kontots tillgodohavande innan du försöker igen.

Fel och ofullständigt lyckade resultat

Läs både HTTP-statusen och status.code/status.msg i JSON-svaret. Ett tomt resultat från standarduppslagningen returnerar API-kod 404. API-kod 403 kan ange otillräckligt saldo på ett förbetalt konto.

En befintlig felväg för frisamtalsnummer kan ändå debitera beloppet för uppslagningen och rapportera API-kod 200 utan användbara routningsfält; kostnadsuppgiften kan vara ofullständig. Enbart koden 200 visar därför inte att uppslagningen är användbar. Validera de fält som din applikation behöver, stäm av osäkra debiteringar mot kontots faktureringsunderlag och kontakta supporten vid ofullständiga resultat.

I den granskade implementationen hanteras frisamtalsnummer olika beroende på indatas längd. Använd helst hela numret med internationell landskod, enbart som siffror, och be supporten bekräfta att det stöd för frisamtalsnummer som du behöver finns. Försök inte automatiskt igen efter ett felaktigt formaterat eller ofullständigt resultat, och förlita dig inte på en routningsuppslagning för att avgöra om det är säkert eller tillåtet att ringa ett nummer.