Izstrādātājiem

GET/v3/nanpacheck/{number}

Pārbaudiet Ziemeļamerikas numuru piešķīrumu pārklājumu

Salīdziniet numuru ar piešķīrumu tabulu, neuzskatot šo pārbaudi par abonenta vai numura pieejamības pārbaudi.

Šajā lapā
  1. Pārbaudiet piešķīrumu tabulas pārklājumu
  2. Pieprasījums
  3. Atbilde
  4. Kļūdas
  5. Izmaksas un turpmākās darbības

Pārbaudiet piešķīrumu tabulas pārklājumu

Pārbaudiet, vai Ziemeļamerikas numurs atbilst kādam prefiksam MultiTEL piešķīrumu tabulā, un iegūstiet ar to saistīto pilsētu, štatu un valsti. Tā ir meklēšana prefiksu tabulā. Tā neapstiprina, ka abonents ir aktīvs, ka numurs ir piešķirts, ka tas pieder jūsu kontam vai ka varat to pasūtīt.

Pieprasījums

Izmantojiet savu iespējoto API kontu un atļauto avota IP adresi. Piemērā tiek izmantoti HTTP Basic autentifikācijas dati no vides mainīgajiem un izdomāts numurs. Pieprasījuma pamatteksts nav nepieciešams.

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

Ieteicams izmantot vienpadsmit ciparu Ziemeļamerikas numuru, kas sākas ar 1. Apstrādātājs noņem rakstzīmes, kas nav cipari, un desmit ciparu ievades sākumā pievieno 1. Ievade ar citu ciparu skaitu tiek noraidīta. Šī normalizēšana nepārbauda visus Ziemeļamerikas numerācijas noteikumus, tāpēc atrasta atbilstība tabulā nav visaptveroša numura derīguma pārbaude.

Atbilde

Lauku vērtības ir sniegtas tikai ilustrācijai; tas nav faktiskās piešķīrumu tabulas vaicājuma rezultāts.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
Piešķīruma atbilstības lauki
LauksNozīme
numberNormalizēta ievade, kas satur tikai ciparus.
npanxxAtbilstošais saglabātais prefikss. Apstrādātājs dod priekšroku septiņu ciparu valsts/apgabala/centrāles prefiksam un vajadzības gadījumā var izmantot četru ciparu valsts/apgabala prefiksu; nepieņemiet, ka šis lauks vienmēr identificē pilnu centrāles kodu.
city, state, countryAtbilstošā piešķīruma prefiksa metadati. Šie lauki nenorāda abonenta pašreizējo fizisko atrašanās vietu vai pašreizējo operatoru pēc numura pārnešanas.

Kļūdas

Lasiet JSON lauku status.code, nevis paļaujieties tikai uz HTTP 200. API kods 404 ar ziņojumu Not part of NANPA nozīmē, ka pakalpojuma izmantotajā tabulā nav atrasts atbilstošs prefikss; tas nav galīgs pasaules numerācijas iestāžu atzinums. API kods 500 tiek izmantots, ja ciparu skaits nav derīgs vai numurs nav norādīts.

Izmaksas un turpmākās darbības

Pārskatītais apstrādātājs veic vaicājumu vietējā piešķīrumu tabulā un neietver līdzekļu norakstīšanu no konta vai ārēju meklēšanu. Šis apstrādātājs nepiemēro maksu par meklēšanu. Izmantojiet pieejamo numuru meklēšanu, lai atrastu pasūtīšanai pieejamos numurus. Nosaukuma meklēšana, maršrutēšanas datu meklēšana vai numura pasūtīšana ir atsevišķa darbība, kurai ir sava kontam piemērojamā cena.