Slå routingoplysninger op

Anmod om routingoplysninger for et nordamerikansk telefonnummer. Brug dem til at fortolke tilgængelige routing- og operatørdata, ikke som bevis for abonnentens identitet, ejerskab, muligheden for at komme i kontakt eller muligheden for at købe nummeret. Et opslag kan medføre en debitering af din konto.

Anmodning

Brug din aktiverede API-konto og dens tilladte kilde-IP-adresse. Angiv hele nummeret som cifre inklusive landekode 1. Eksemplet bruger miljøvariabler og et fiktivt nummer. Behandlingsfunktionen normaliserer ikke tegnsætning; valider inputtet, før du sender det.

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

Svar

Kun udvalgte felter vises som illustration; tilgængeligheden afhænger af kilden og nummertypen.

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

Standardopslaget konverterer de returnerede feltnavne til små bogstaver. Afhængigt af kilden kan svaret indeholde felter for operatør, takstområde, placering og jurisdiktion. Svaret er ikke en fast, fuldstændig abonnentpost. Flaget local kan være tallet 1 eller strengen 0. Behandlingsfunktionen beregner ported ved at sammenligne det returnerede routingnummer med det angivne telefonnummer; fortolk det ikke som en verificeret, fuldstændig historik over nummerporteringer.

Pris og gentagne forsøg

Den gennemgåede behandlingsfunktion debiterer kontoen med $0.00025, når den når til sin afsluttende behandlingsgren og registrerer opslaget. Den returnerede pris angives normalt som en streng med dollartegnet, ikke blot som et tal. Der stilles ingen idempotensnøgle til rådighed. Hvis en anmodning gentages, kan det medføre endnu en debitering.

For forudbetalte konti kontrollerer koden, at saldoen er mindst 0.00025. Meddelelsen om utilstrækkelig saldo nævner i øjeblikket $5, hvilket ikke stemmer overens med denne grænse. Fortolk fejlen som en afvisning på grund af saldoen, og kontroller, at der er penge på kontoen, før du prøver igen.

Fejl og ufuldstændigt gennemførte opslag

Læs både HTTP-status og status.code/status.msg i JSON. Et tomt resultat fra et standardopslag returnerer API-kode 404. API-kode 403 kan angive utilstrækkelig forudbetalt saldo.

En af de nuværende fejlgrene for frikaldsnumre kan stadig debitere beløbet for opslaget og returnere API-kode 200 uden brugbare routingfelter; prisoplysningen kan være ufuldstændig. Kode 200 alene bekræfter derfor ikke, at opslaget er brugbart. Valider de felter, din applikation har brug for, afstem usikre debiteringer med kontoens faktureringsposter, og kontakt support ved ufuldstændige resultater.

I den gennemgåede implementering afhænger håndteringen af frikaldsnumre af inputtets længde. Brug helst hele nummeret som cifre i internationalt format, og få support til at bekræfte den nødvendige dækning af frikaldsnumre. Gentag ikke automatisk anmodningen ved et forkert formateret eller ufuldstændigt resultat, og brug ikke et routingopslag som grundlag for at afgøre, om det er sikkert eller tilladt at ringe til et nummer.