Maršrutēšanas informācijas uzmeklēšana

Pieprasiet maršrutēšanas informāciju par Ziemeļamerikas tālruņa numuru. Izmantojiet to, lai interpretētu pieejamos maršrutēšanas un operatora datus, nevis kā pierādījumu abonenta identitātei, numura piederībai, sasniedzamībai vai pieejamībai iegādei. Par uzmeklēšanu no jūsu konta var tikt ieturēta maksa.

Pieprasījums

Izmantojiet savu aktivizēto API kontu un tam atļauto avota IP adresi. Norādiet pilnu numuru tikai ar cipariem, iekļaujot valsts kodu 1. Piemērā tiek izmantoti vides mainīgie un izdomāts numurs. Apstrādātājs nenormalizē pieturzīmes; pirms iesniegšanas pārbaudiet ievades derīgumu.

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

Atbilde

Ilustrācijai parādīti tikai atlasīti lauki; to pieejamība ir atkarīga no avota un numura veida.

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

Standarta uzmeklēšanā atgriezto lauku nosaukumi tiek pārveidoti par mazajiem burtiem. Atkarībā no avota var būt iekļauti operatora, tarifikācijas centra, atrašanās vietas un jurisdikcijas lauki. Atbilde nav nemainīgs, pilnīgs abonenta ieraksts. Karodziņš local var būt skaitlis 1 vai virkne 0. Apstrādātājs aprēķina ported, salīdzinot atgriezto maršrutēšanas numuru ar norādīto tālruņa numuru; neinterpretējiet to kā pārbaudītu, pilnīgu numura pārnešanas vēsturi.

Cena un atkārtoti mēģinājumi

Pārskatītais apstrādātājs ietur no konta $0.00025, kad tas sasniedz izpildes pabeigšanas posmu un reģistrē uzmeklēšanu. Atgrieztās izmaksas parasti ir norādītas kā virkne ar dolāra zīmi, nevis tikai kā skaitliska summa. Idempotences atslēga nav pieejama. Atkārtots pieprasījums var izraisīt vēl vienu maksas ieturēšanu.

Priekšapmaksas kontiem kods pārbauda, vai atlikums ir vismaz 0.00025. Ziņojumā par nepietiekamu atlikumu pašlaik ir minēti $5, kas neatbilst šim slieksnim. Interpretējiet šo kļūmi kā noraidījumu nepietiekama atlikuma dēļ un pirms atkārtota mēģinājuma pārliecinieties, ka kontā ir līdzekļi.

Kļūmes un nepilnīgi veiksmīgi rezultāti

Pārbaudiet gan HTTP statusu, gan JSON laukus status.code/status.msg. Ja standarta uzmeklēšanas rezultāts ir tukšs, tiek atgriezts API kods 404. API kods 403 var norādīt uz nepietiekamu priekšapmaksas atlikumu.

Pašreizējais bezmaksas numuru kļūdu apstrādes scenārijs joprojām var ieturēt uzmeklēšanas maksu un atgriezt API kodu 200 bez noderīgiem maršrutēšanas laukiem; informācija par izmaksām var būt nepilnīga. Tāpēc kods 200 pats par sevi neapliecina, ka uzmeklēšanas rezultāts ir izmantojams. Pārbaudiet lietotnei nepieciešamo lauku derīgumu, salīdziniet neskaidros maksājumus ar konta norēķinu ierakstiem un nepilnīgu rezultātu gadījumā sazinieties ar atbalsta dienestu.

Pārskatītajā realizācijā bezmaksas numuru apstrāde atšķiras atkarībā no ievades garuma. Dodiet priekšroku pilnam numuram starptautiskajā formātā, kas norādīts tikai ar cipariem, un ar atbalsta dienestu pārliecinieties par nepieciešamo bezmaksas numuru aptvērumu. Ja rezultāts ir nepareizi formatēts vai nepilnīgs, neatkārtojiet pieprasījumu automātiski un nepaļaujieties uz maršrutēšanas informācijas uzmeklēšanu, lai izlemtu, ka zvanīt uz numuru ir droši vai atļauts.