Maršruto parinkimo informacijos paieška

Pateikite užklausą dėl Šiaurės Amerikos telefono numerio maršruto parinkimo informacijos. Naudokite ją turimiems maršruto parinkimo ir operatoriaus duomenims interpretuoti, o ne kaip abonento tapatybės, numerio nuosavybės, galimybės susisiekti ar įsigyti numerį įrodymą. Už paiešką iš jūsų paskyros gali būti nuskaičiuotas mokestis.

Užklausa

Naudokite savo įgalintą API paskyrą ir jai leidžiamą šaltinio IP adresą. Pateikite visą numerį skaitmenimis, įskaitant šalies kodą 1. Pavyzdyje naudojami aplinkos kintamieji ir išgalvotas numeris. Užklausų apdorojimo kodas nenormalizuoja skyrybos ženklų; prieš pateikdami patikrinkite įvestį.

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

Atsakymas

Pateikiami tik iliustracijai parinkti laukai; jų prieinamumas priklauso nuo šaltinio ir numerio tipo.

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

Atliekant standartinę paiešką, grąžinamų laukų pavadinimai paverčiami mažosiomis raidėmis. Atsižvelgiant į šaltinį, gali būti pateikti operatoriaus, tarifinės zonos centro, vietovės ir jurisdikcijos laukai. Atsakymas nėra fiksuotos sudėties išsamus abonento įrašas. Žymos local reikšmė gali būti skaičius 1 arba eilutė 0. Užklausų apdorojimo kodas apskaičiuoja ported reikšmę palygindamas grąžintą maršruto parinkimo numerį su pateiktu telefono numeriu; nelaikykite jos patikrinta išsamia numerio perkėlimo istorija.

Kaina ir pakartotiniai bandymai

Peržiūrėtas užklausų apdorojimo kodas nuskaičiuoja iš paskyros $0.00025, kai pasiekia užbaigimo etapą ir užregistruoja paiešką. Grąžinama kainos reikšmė paprastai yra eilutė su dolerio ženklu, o ne vien skaitinė suma. Idempotentiškumo raktas nepateikiamas. Pakartojus užklausą gali būti pritaikytas dar vienas mokestis.

Išankstinio mokėjimo paskyroms kodas tikrina, ar likutis yra bent 0.00025. Pranešime apie nepakankamą likutį šiuo metu nurodoma $5 suma, kuri neatitinka šios ribos. Šią nesėkmę vertinkite kaip užklausos atmetimą dėl likučio ir prieš bandydami dar kartą įsitikinkite, kad paskyroje pakanka lėšų.

Nesėkmės ir dalinė sėkmė

Patikrinkite ir HTTP būseną, ir JSON laukus status.code/status.msg. Kai standartinės paieškos rezultatas tuščias, grąžinamas API kodas 404. API kodas 403 gali reikšti nepakankamą išankstinio mokėjimo paskyros likutį.

Pagal dabartinį nemokamų skambučių numerių klaidų apdorojimo scenarijų paieškos mokestis vis tiek gali būti nuskaičiuotas ir pateiktas API kodas 200 be naudingų maršruto parinkimo laukų; kainos duomenys gali būti neišsamūs. Todėl vien kodas 200 nepatvirtina, kad paieškos rezultatas tinkamas naudoti. Patikrinkite jūsų programai reikalingus laukus, neaiškius mokesčius sutikrinkite su paskyros atsiskaitymo įrašais, o dėl neišsamių rezultatų kreipkitės į pagalbos tarnybą.

Peržiūrėtoje realizacijoje nemokamų skambučių numerių apdorojimas skiriasi priklausomai nuo įvesties ilgio. Pirmenybę teikite visam numeriui tarptautiniu formatu, sudarytam tik iš skaitmenų, ir su pagalbos tarnyba patikslinkite, ar palaikomi jums reikalingi nemokamų skambučių numeriai. Gavę netaisyklingo formato arba neišsamų rezultatą, automatiškai nekartokite užklausos ir nesiremkite maršruto parinkimo informacijos paieška spręsdami, ar skambinti numeriu saugu arba leidžiama.