Slå opp rutingsinformasjon

Be om rutingsinformasjon for et nordamerikansk telefonnummer. Bruk informasjonen til å tolke tilgjengelige rutings- og operatørdata, ikke som bevis på abonnentens identitet, eierskap til nummeret, om det kan nås, eller om det er tilgjengelig for kjøp. Et oppslag kan belaste kontoen din.

Forespørsel

Bruk den aktiverte API-kontoen din og kilde-IP-adressen som er tillatt for kontoen. Oppgi hele nummeret med bare sifre, inkludert landskode 1. Eksemplet bruker miljøvariabler og et oppdiktet nummer. Behandlingskoden normaliserer ikke tegnsetting; valider inndataene før du sender forespørselen.

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

Svar

Bare utvalgte felt vises som illustrasjon; tilgjengeligheten avhenger av kilden og nummertypen.

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

Standardoppslaget gjør feltnavnene i svaret om til små bokstaver. Avhengig av kilden kan svaret inneholde felt for operatør, takstområde, geografisk plassering og jurisdiksjon. Svaret er ikke en fullstendig abonnentoppføring med fast struktur. Flagget local kan være tallverdien 1 eller strengverdien 0. Behandlingskoden beregner ported ved å sammenligne rutingsnummeret i svaret med det oppgitte telefonnummeret; ikke tolk dette som en bekreftet, fullstendig porteringshistorikk.

Pris og gjentatte forsøk

Den gjennomgåtte behandlingskoden belaster kontoen med $0.00025 når den når fullføringsgrenen og registrerer oppslaget. Kostnaden i svaret er normalt en streng som inkluderer dollartegnet, fremfor bare et tallbeløp. Ingen idempotensnøkkel er tilgjengelig. Hvis du gjentar en forespørsel, kan det føre til en ny belastning.

For forhåndsbetalte kontoer kontrollerer koden at saldoen er minst 0.00025. Meldingen om utilstrekkelig saldo nevner for øyeblikket $5, noe som ikke samsvarer med denne terskelen. Tolk feilen som en avvisning på grunn av saldoen, og kontroller at kontoen har tilstrekkelige midler før du prøver igjen.

Feil og ufullstendige vellykkede resultater

Les både HTTP-statusen og status.code/status.msg i JSON-svaret. Et tomt resultat fra standardoppslaget gir API-kode 404. API-kode 403 kan bety at saldoen på en forhåndsbetalt konto er utilstrekkelig.

En av de nåværende feilgrenene for gratisnumre kan likevel trekke oppslagsbeløpet og rapportere API-kode 200 uten brukbare rutingsfelt; kostnadsopplysningen kan være ufullstendig. Kode 200 alene bekrefter derfor ikke at oppslaget har gitt et brukbart resultat. Valider feltene applikasjonen din trenger, avstem usikre belastninger mot kontoens faktureringsoppføringer, og kontakt kundestøtte ved ufullstendige resultater.

I den gjennomgåtte implementasjonen varierer håndteringen av gratisnumre med lengden på inndataene. Bruk helst hele det internasjonale nummeret med bare sifre, og få kundestøtte til å bekrefte at den nødvendige dekningen for gratisnumre støttes. Ikke gjenta forespørselen automatisk ved et feilformatert eller ufullstendig resultat, og ikke bruk et rutingsoppslag som grunnlag for å avgjøre om det er trygt eller tillatt å ringe et nummer.