Dohvat podataka o usmjeravanju

Zatražite podatke o usmjeravanju za sjevernoamerički telefonski broj. Upotrijebite ih za tumačenje dostupnih podataka o usmjeravanju i operatoru, a ne kao dokaz identiteta pretplatnika, vlasništva, mogućnosti uspostavljanja veze ili dostupnosti broja za kupnju. Upit može dovesti do terećenja vašeg računa.

Zahtjev

Upotrijebite svoj omogućeni račun za API i njegovu dopuštenu izvorišnu IP adresu. Navedite cijeli broj u obliku znamenki, uključujući pozivni broj države 1. Primjer upotrebljava varijable okruženja i izmišljeni broj. Funkcija za obradu ne normalizira interpunkcijske znakove; provjerite valjanost unosa prije slanja.

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

Odgovor

Prikazana su samo odabrana polja radi ilustracije; dostupnost ovisi o izvoru i vrsti broja.

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

Standardni upit pretvara nazive vraćenih polja u mala slova. Ovisno o izvoru, mogu biti prisutna polja za operatora, tarifno područje, lokaciju i jurisdikciju. Odgovor nije nepromjenjiv, potpun zapis o pretplatniku. Oznaka local može biti broj 1 ili niz znakova 0. Funkcija za obradu izračunava ported usporedbom vraćenog broja za usmjeravanje s navedenim telefonskim brojem; nemojte to tumačiti kao provjerenu, potpunu povijest prijenosa broja.

Cijena i ponovni pokušaji

Pregledana funkcija za obradu tereti račun za $0.00025 kada dođe do završne grane obrade i zabilježi upit. Vraćeni trošak obično je niz znakova koji uključuje znak dolara, a ne samo brojčani iznos. Ključ idempotentnosti nije dostupan. Ponavljanje zahtjeva može dovesti do nove naplate.

Za račune s plaćanjem unaprijed kod provjerava iznosi li stanje najmanje 0.00025. Poruka o nedostatnom stanju trenutačno spominje $5, što ne odgovara tom pragu. Protumačite pogrešku kao odbijanje zbog stanja računa i provjerite sredstva na računu prije ponovnog pokušaja.

Neuspjesi i nepotpuno uspješni upiti

Pročitajte i status HTTP i status.code/status.msg u formatu JSON. Prazan rezultat standardnog upita vraća kod API 404. Kod API 403 može označavati nedostatno stanje računa s plaćanjem unaprijed.

Jedna od trenutačnih grana obrade pogrešaka za besplatne brojeve i dalje može naplatiti iznos upita i prijaviti kod API 200 bez korisnih polja za usmjeravanje; podatak o trošku može biti nepotpun. Sam kod 200 stoga ne potvrđuje da je rezultat upita upotrebljiv. Provjerite valjanost polja potrebnih vašoj aplikaciji, usporedite nejasne naplate s obračunskim evidencijama računa i obratite se podršci za nepotpune rezultate.

U pregledanoj implementaciji obrada besplatnih brojeva razlikuje se ovisno o duljini unosa. Prednost dajte cijelom broju u znamenkama u međunarodnom formatu i s podrškom potvrdite potrebnu pokrivenost besplatnih brojeva. Nemojte automatski ponavljati zahtjev nakon neispravno oblikovanog ili nepotpunog rezultata i nemojte se oslanjati na upit o usmjeravanju kako biste zaključili da je pozivanje broja sigurno ili dopušteno.