MultiTEL
Arendajad

GET/v3/getmobilecount/{prefix_id}

Kontrollige telefonikeskjaama mobiililaoseisu

Hangige sobiva prefiksi esindatava NPA/NXX-i jaoks hetktõmmisena mobiililaoseisu arvu. See on saadavuse vihje, mitte reserveering ega ostu tagatis.

Sellel lehel
  1. Valige toetatud prefiks
  2. Kasutage arvu viitena
  3. Eristage nullist laoseisu ebaõnnestunud päringust
  4. Päring
  5. Vastus
  6. Vead
  7. Saadavus ja kõrvalmõjud

Valige toetatud prefiks

Kasutage avastuselt saadud praegust individuaalset mobiiliprefiksit. See otspunkt on mõeldud NANPA telefonikeskjaamadele: NPA tähistab suunakoodi ja NXX telefonikeskjaama. Ainult suunakoodist koosnev prefiks on liiga lai. Ärge saatke rühmitatud kuvatunnuseid ega järeldage teise riigi toetust sellepärast, et selle prefiks sisaldab piisavalt numbreid.

Kasutage arvu viitena

Lugege response.count, kus response.npa ja response.nxx tähistavad telefonikeskjaama. See on katvusteenuse hetktõmmis, mitte teie kontole hoitud laoseis. Kinnitage enne tellimist tegelikud numbrid, kohaldatavad hinnapakkumised ja võimalikud registreerimisnõuded. Edukas loendus ei anna kunagi ostuõigust.

Eristage nullist laoseisu ebaõnnestunud päringust

Edukas nullloendus erineb API veast. Kontrollige status.code ja status.msg ning samuti HTTP olekut. Käsitlege aegumist või ebaõnnestunud päringut teadmata saadavusena ja proovige hiljem uuesti kasvavate pausidega (backoff).

Päring

Kasutage oma lubatud API-konto andmeid HTTPS kaudu. Toetatud on Basic autentimine ja lubatud API-konto kandjatunnused; kehtivad kontopiirangud.

GET koos prefiksi identifikaatoriga URL-i teel. Dokumenteeritud päringu- ega sisuparameetreid pole.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"
Teeparameetrid
NimiTüüpNõutavKirjeldus
prefix_idstringJahKopeerige avastuse vastusest individuaalse prefiksi ID. Kasutage toetatud NANPA mobiiliprefiksit, mis sisaldab suunakoodi (NPA) ja telefonikeskjaama (NXX), mitte ainult suunakoodi ega rühmitatud kokkuvõtte ID-d. Käsitlege identifikaatorit läbipaistmatuna.

Vastus

Kontrollige status.code JSON-vastuse sisus ning samuti HTTP olekut. Edukas response sisaldab status.code 200 ja status.msg Results. response on objekt, mitte loend: count on täisarvuline laoseisu hetktõmmis; npa ja nxx on kolmemärgilised stringid. status.results ei ole selle assotsiatiivse objekti puhul olemas. Loendus 0 tähendab, et katvuspäringul ei leitud vastavat telefonikeskjaama või see tagastas null laoseisu; see ei tõenda, et kõigil tarnijatel või muudel avastusteedel numbreid ei oleks.

Illustreeriv vastuse kuju; mitte tegelikud kontoandmed ega kehtiv hinnapakkumine.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

Vead

  • 404: Teenusepakkuja on keelatud: mobiililaoseisu katvus pole teenuses saadaval.
  • 404: Vigane prefiksi ID: hankige avastuselt praegune individuaalne prefiksi ID.
  • 404: Vigane prefiks: salvestatud prefiks ei sisalda NPA/NXX päringuks piisavalt numbreid.
  • 500: Laoseisu katvus ebaõnnestus: ülesvoolu päring ei tagastanud edukat katvuse tulemust. Proovige hiljem uuesti kasvavate pausidega (backoff); ebaõnnestumine ei ole nullne laoseisu loendus.

Saadavus ja kõrvalmõjud

  • Operatsioon kontrollib laoseisu ega esita tellimust, ei reserveeri numbreid ega debiteeri ostusummat.
  • Laoseis võib muutuda koheselt. Katvuse loendust ei kohandata nii, et see lubaks kontopõhist ostetavust või sama pikkust nagu järgmise numbriotsingu vastus.
  • Päring võtab ühendust katvusteenusega ja võib aega võtta. Ärge küsitlege korduvalt iga prefiksit ega käsitlege aegumist/viga eduka nullse laoseisuna.