Arendajad

GET/v3/nanpacheck/{number}

Kontrollige Põhja-Ameerika numbri olemasolu eraldustabelis

Võrrelge numbrit eraldustabeliga, käsitamata seda abonendi või numbri saadavuse kontrollina.

Sellel lehel
  1. Kontrollige numbri olemasolu eraldustabelis
  2. Päring
  3. Vastus
  4. Vead
  5. Hind ja järgmised sammud

Kontrollige numbri olemasolu eraldustabelis

Kontrollige, kas Põhja-Ameerika number vastab mõnele MultiTELi eraldustabeli prefiksile, ning hankige sellega seotud linn, osariik ja riik. See on otsing prefiksitabelist. See ei tõenda, et abonent on aktiivne, et number on määratud, et see kuulub teie kontole või et saate seda tellida.

Päring

Kasutage oma aktiveeritud API kontot ja lubatud lähte-IP-aadressi. Näites kasutatakse keskkonnamuutujatest saadud HTTP Basic autentimisandmeid ja väljamõeldud numbrit. Päringu keha ei ole vajalik.

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

Eelistage üheteistkümnekohalist Põhja-Ameerika numbrit, mis algab numbriga 1. Päringutöötleja eemaldab kõik märgid peale numbrite ja lisab kümnekohalise sisendi ette 1. Muu numbrikohtade arvuga sisendid lükatakse tagasi. See normaliseerimine ei kontrolli kõiki Põhja-Ameerika numeratsioonireegleid, seega ei tähenda tabelist vaste leidmine numbri täielikku kontrollimist.

Vastus

Väljade väärtused on üksnes näitlikud; see ei ole kasutusel olevast eraldustabelist saadud tulemus.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
Eraldustabeli vaste väljad
VäliTähendus
numberNormaliseeritud sisend, mis sisaldab ainult numbreid.
npanxxVasteks leitud salvestatud prefiks. Päringutöötleja eelistab seitsmekohalist riigi-, piirkonna- ja keskjaamakoodist koosnevat prefiksit ning võib selle puudumisel kasutada neljakohalist riigi- ja piirkonnakoodist koosnevat prefiksit; ärge eeldage, et see väli määratleb alati täieliku keskjaamakoodi.
city, state, countryVasteks leitud eraldusprefiksi metaandmed. Need väljad ei näita abonendi praegust füüsilist asukohta ega praegust sideoperaatorit pärast numbri teisaldamist.

Vead

Lugege JSON vastuse välja status.code, selle asemel et tugineda üksnes HTTP olekukoodile 200. API kood 404 koos teatega Not part of NANPA tähendab, et teenuse kasutatavast tabelist ei leitud ühtegi sobivat prefiksit; see ei ole ülemaailmse numeratsiooni eest vastutava asutuse lõplik otsus. API koodi 500 kasutatakse vale numbrikohtade arvu või puuduva numbri korral.

Hind ja järgmised sammud

Üle vaadatud päringutöötleja teeb päringu kohalikku eraldustabelisse ega sisalda konto debiteerimist ega välist otsingut. See päringutöötleja ei võta otsingutasu. Kasutage saadaolevate numbrite otsingut tellitavate numbrite leidmiseks. Nimepäring, marsruutimise päring või numbri tellimine on eraldi toiming, millele kehtib konto vastav hinnastus.