Hae reititystietoja

Pyydä pohjoisamerikkalaisen puhelinnumeron reititystiedot. Käytä niitä saatavilla olevien reititys- ja operaattoritietojen tulkitsemiseen, älä todisteena tilaajan henkilöllisyydestä, numeron omistuksesta, tavoitettavuudesta tai siitä, että numeron voi ostaa. Haku voi aiheuttaa veloituksen tilillesi.

Pyyntö

Käytä aktivoitua API-tiliäsi ja sille sallittua lähde-IP-osoitetta. Anna koko numero pelkkinä numeroina, mukaan lukien maatunnus 1. Esimerkissä käytetään ympäristömuuttujia ja kuvitteellista numeroa. Käsittelijä ei normalisoi välimerkkejä; tarkista syötteen kelvollisuus ennen lähettämistä.

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

Vastaus

Esimerkissä näytetään vain valitut kentät; niiden saatavuus riippuu lähteestä ja numerotyypistä.

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

Vakiohaku muuntaa palautettujen kenttien nimet pienaakkosiksi. Lähteestä riippuen mukana voi olla operaattoria, hinnoittelualuetta, sijaintia ja lainkäyttöaluetta koskevia kenttiä. Vastaus ei ole kiinteä, täydellinen tilaajatietue. local-lippu voi olla numeroarvo 1 tai merkkijono 0. Käsittelijä laskee ported-arvon vertaamalla palautettua reititysnumeroa annettuun puhelinnumeroon; älä tulkitse sitä varmennetuksi, täydelliseksi numeronsiirtohistoriaksi.

Hinta ja uudelleenyritykset

Tarkistettu käsittelijä veloittaa tililtä $0.00025, kun se saavuttaa suorituksensa päättävän koodipolun ja kirjaa haun. Palautettu hinta on tavallisesti dollarimerkin sisältävä merkkijono eikä pelkkä numeerinen summa. Idempotenssiavainta ei ole tarjolla. Pyynnön toistaminen voi aiheuttaa uuden veloituksen.

Ennakkoon maksettujen tilien osalta koodi tarkistaa, että saldo on vähintään 0.00025. Riittämättömästä saldosta kertovassa viestissä mainitaan tällä hetkellä $5, mikä ei vastaa kyseistä rajaa. Tulkitse virhe saldosta johtuvaksi hylkäykseksi ja varmista tilin varat ennen uutta yritystä.

Virheet ja osittain onnistuneet haut

Lue sekä HTTP-tilakoodi että JSON-vastauksen status.code/status.msg. Tyhjä vakiohaun tulos palauttaa API-koodin 404. API-koodi 403 voi tarkoittaa ennakkoon maksetun tilin riittämätöntä saldoa.

Nykyinen maksuttomien palvelunumeroiden virhepolku voi silti veloittaa haun hinnan ja ilmoittaa API-koodin 200 ilman käyttökelpoisia reitityskenttiä; hintatieto voi olla puutteellinen. Pelkkä koodi 200 ei siis osoita, että haun tulos on käyttökelpoinen. Tarkista sovelluksesi tarvitsemien kenttien kelvollisuus, vertaa epäselviä veloituksia tilin laskutustietoihin ja ota yhteyttä tukeen, jos tulokset ovat puutteellisia.

Tarkistetussa toteutuksessa maksuttomien palvelunumeroiden käsittely vaihtelee syötteen pituuden mukaan. Käytä mieluiten koko kansainvälistä numeroa pelkkinä numeroina ja varmista tuelta, että tarvitsemasi maksuttomat palvelunumerot kuuluvat tuen piiriin. Älä yritä hakua automaattisesti uudelleen virheellisen muotoisen tai puutteellisen tuloksen jälkeen, äläkä päättele reitityshaun perusteella, että numeroon soittaminen on turvallista tai sallittua.