Marsruutimisinfo pärimine

Pärige Põhja-Ameerika telefoninumbri marsruutimisinfot. Kasutage seda saadaolevate marsruutimis- ja sideoperaatoriandmete tõlgendamiseks, mitte tõendina abonendi isiku, numbri omandiõiguse, kättesaadavuse või ostmiseks saadaval olemise kohta. Päringu eest võidakse teie kontolt tasu võtta.

Päring

Kasutage oma aktiveeritud API kontot ja sellele lubatud lähte-IP-aadressi. Esitage täielik number ainult numbritena, sealhulgas riigikood 1. Näites kasutatakse keskkonnamuutujaid ja väljamõeldud numbrit. Päringutöötleja ei normaliseeri kirjavahemärke; kontrollige sisendi kehtivust enne saatmist.

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

Vastus

Näidatud on ainult valitud väljad; nende olemasolu sõltub allikast ja numbri tüübist.

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

Tavapäring teisendab tagastatud väljanimed väiketähtedeks. Olenevalt allikast võivad vastuses olla sideoperaatori, tariifipiirkonna, asukoha ja jurisdiktsiooni väljad. Vastus ei ole muutumatu täielik abonendikirje. Lipu local väärtus võib olla arv 1 või string 0. Päringutöötleja arvutab välja ported väärtuse, võrreldes tagastatud marsruutimisnumbrit esitatud telefoninumbriga; ärge tõlgendage seda kontrollitud täieliku numbri teisaldamise ajaloona.

Hind ja korduspäringud

Üle vaadatud päringutöötleja debiteerib kontolt $0.00025, kui jõuab töötluse lõpetamise harusse ja registreerib päringu. Tagastatud maksumus on tavaliselt dollarimärki sisaldav string, mitte pelgalt arvuline summa. Idempotentsusvõtit ei ole saadaval. Päringu kordamine võib põhjustada uue tasu.

Ettemaksukontode puhul kontrollib kood, kas saldo on vähemalt 0.00025. Ebapiisava saldo teates mainitakse praegu summat $5, mis ei vasta sellele lävendile. Tõlgendage seda tõrget saldost tingitud keeldumisena ja veenduge enne uut katset, et kontol on piisavalt raha.

Tõrked ja osaliselt õnnestunud päringud

Kontrollige nii HTTP olekut kui ka JSON välju status.code/status.msg. Tühja tavapäringu tulemuse korral tagastatakse API kood 404. API kood 403 võib viidata ebapiisavale ettemaksusaldole.

Praegune tasuta numbrite tõrkeharu võib siiski debiteerida päringutasu ja tagastada API koodi 200 ilma kasulike marsruutimisväljadeta; maksumuse teave võib olla puudulik. Seega ei kinnita ainuüksi kood 200, et päringu tulemus on kasutatav. Kontrollige oma rakenduse jaoks vajalike väljade kehtivust, võrrelge ebaselgeid tasusid konto arvelduskirjetega ja võtke puudulike tulemuste korral ühendust kasutajatoega.

Üle vaadatud teostuses erineb tasuta numbrite töötlemine olenevalt sisendi pikkusest. Eelistage täielikku rahvusvahelist numbrit, mis on esitatud ainult numbritena, ja kinnitage kasutajatoega vajalike tasuta numbrite toetatus. Vigase vorminguga või puuduliku tulemuse korral ärge korrake päringut automaatselt ning ärge tuginege marsruutimisinfo päringule otsustamaks, et numbrile helistamine on ohutu või lubatud.