Tarkista numerovaraustaulukon kattavuus
Tarkista, vastaako pohjoisamerikkalainen numero jotakin MultiTELin numerovaraustaulukon etuliitettä, ja hae siihen liittyvä kaupunki, osavaltio ja maa. Kyseessä on haku etuliitetaulukosta. Se ei osoita, että liittymä on aktiivinen, numero on annettu tilaajan käyttöön, numero kuuluu tilillesi tai voit tilata sen.
Pyyntö
Käytä API-tiliäsi, joka on otettu käyttöön, ja sallittua lähde-IP-osoitetta. Esimerkissä käytetään ympäristömuuttujista luettavia HTTP Basic -tunnuksia ja kuvitteellista numeroa. Pyynnön runkoa ei tarvita.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Käytä mieluiten yksitoistanumeroista pohjoisamerikkalaista numeroa, joka alkaa numerolla 1. Käsittelijä poistaa muut merkit kuin numerot ja lisää kymmennumeroisen syötteen alkuun numeron 1. Muut numeromäärät hylätään. Tämä normalisointi ei tarkista kaikkia Pohjois-Amerikan numerointisääntöjä, joten taulukosta löytyvä vastaavuus ei tarkoita numeron kattavaa kelpoisuustarkistusta.
Vastaus
Kenttien arvot ovat vain havainnollistavia esimerkkejä; kyseessä ei ole käytössä olevasta numerovaraustaulukosta saatu tulos.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Kenttä | Merkitys |
|---|---|
| number | Normalisoitu syöte, joka sisältää vain numeroita. |
| npanxx | Vastaava tallennettu etuliite. Käsittelijä käyttää ensisijaisesti seitsennumeroista maa-, alue- ja keskuskoodista koostuvaa etuliitettä ja voi käyttää sen sijasta nelinumeroista maa- ja aluekoodista koostuvaa etuliitettä; älä oleta, että tämä kenttä yksilöi aina koko keskuskoodin. |
| city, state, country | Vastaavan numerovarauksen etuliitteen metatiedot. Nämä kentät eivät ilmaise tilaajan nykyistä fyysistä sijaintia eivätkä nykyistä operaattoria numeronsiirron jälkeen. |
Virheet
Lue JSON-vastauksen status.code-kenttä sen sijaan, että luottaisit pelkkään HTTP-tilakoodiin 200. API-koodi 404 ja viesti Not part of NANPA tarkoittavat, ettei palvelun käyttämästä taulukosta löytynyt vastaavaa etuliitettä; kyseessä ei ole numerointiviranomaisen lopullinen, maailmanlaajuisesti pätevä ratkaisu. API-koodia 500 käytetään, kun numeroiden määrä on virheellinen tai numero puuttuu.
Kustannukset ja seuraavat vaiheet
Tarkistettu käsittelijä tekee paikallisen kyselyn numerovaraustaulukkoon eikä sisällä tiliveloitusta tai ulkoista hakua. Tämä käsittelijä ei veloita hakumaksua. Käytä vapaiden numeroiden hakua löytääksesi tilattavissa olevia numeroita. Nimihaku, reitityshaku ja numeron tilaaminen ovat erillisiä toimintoja, joilla on omat tilikohtaiset hintansa.