Proverite mobilnu zalihu za centralu

Izaberite podržani prefiks

Koristite trenutni pojedinačni mobilni prefiks iz otkrivanja. Ova krajnja tačka namenjena je za NANPA centrale: NPA identifikuje pozivni broj zone, a NXX identifikuje centralu. Prefiks samo sa pozivnim brojem zone je previše širok. Ne šaljite grupisane identifikatore prikaza i ne zaključujte da je druga zemlja podržana samo zato što njen prefiks sadrži dovoljno cifara.

Koristite brojanje kao nagoveštaj

Pročitajte response.count, sa response.npa i response.nxx koji identifikuju centralu. Ovo je snimak stanja servisa pokrivenosti, ne zaliha držana za vaš nalog. Potvrdite stvarne brojeve, važeće ponude i sve zahteve za registraciju pre naručivanja. Uspešno brojanje nikada ne odobrava kupovinu.

Razlikujte nultu zalihu od neuspešne pretrage

Uspešno brojanje nule razlikuje se od API greške. Proverite status.code i status.msg kao i HTTP status. Tretirajte isteklo vreme ili neuspešnu pretragu kao nepoznatu dostupnost i pokušajte ponovo kasnije sa postepenim odgađanjem.

Zahtev

Koristite akreditive vašeg aktiviranog API naloga preko HTTPS-a. Podržani su Basic autentifikacija i bearer tokeni aktiviranog API naloga; važe ograničenja naloga.

GET sa identifikatorom prefiksa u URL putanji. Nema dokumentovanih parametara upita ili tela zahteva.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

Odgovor

Proverite status.code u JSON telu kao i HTTP status. Uspešan response ima status.code 200 i status.msg Results. response je objekat, a ne lista: count je celobrojni snimak zalihe; npa i nxx su nizovi od tri znaka. status.results nije prisutan za ovaj asocijativni objekat. Brojanje 0 znači da pretraga pokrivenosti nije imala odgovarajuću centralu ili je vratila nultu zalihu; to ne dokazuje da svi dobavljači ili druge rute otkrivanja nemaju brojeve.

Ilustrativni oblik odgovora; nisu podaci stvarnog naloga ni aktuelna ponuda.

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

Greške

• 404: Pružalac je onemogućen: pokrivenost mobilne zalihe nije dostupna na servisu.
• 404: Neispravan identifikator prefiksa: nabavite trenutni pojedinačni identifikator prefiksa iz otkrivanja.
• 404: Neispravan prefiks: sačuvani prefiks ne sadrži dovoljno cifara za NPA/NXX pretragu.
• 500: Neuspeh pokrivenosti zalihe: uzvodna pretraga nije vratila uspešan rezultat pokrivenosti. Pokušajte ponovo kasnije sa postepenim odgađanjem; neuspeh nije brojanje nulte zalihe.

Dostupnost i sporedni efekti

• Operacija proverava zalihu i ne daje porudžbinu, ne rezerviše brojeve i ne zadužuje iznos kupovine.
• Zaliha se može promeniti odmah. Broj pokrivenosti nije prilagođen da obećava kupovinu specifičnu za nalog ili istu dužinu kao sledeći odgovor pretrage brojeva.
• Pretraga kontaktuje servis pokrivenosti i može potrajati. Ne ispitujte iznova svaki prefiks i ne tretirajte isteklo vreme ili grešku kao uspešnu nultu zalihu.