Odaberite podržani prefiks
Koristite trenutačni pojedinačni mobilni prefiks iz otkrivanja. Ova je krajnja točka namijenjena NANPA centralama: NPA označava pozivni broj područja, a NXX označava centralu. Prefiks koji sadrži samo pozivni broj područja preširok je. Ne šaljite grupirane ID-ove za prikaz i ne zaključujte da je druga zemlja podržana zato što njezin prefiks sadrži dovoljno znamenki.
Koristite broj samo kao naznaku
Pročitajte response.count, uz response.npa i response.nxx koji identificiraju centralu. Ovo je snimka stanja servisa pokrivenosti, a ne zaliha rezervirana za vaš račun. Potvrdite stvarne brojeve, primjenjive ponude i sve zahtjeve za registraciju prije naručivanja. Uspješan broj nikada ne ovlašćuje kupnju.
Razlikujte nultu zalihu od neuspješnog pretraživanja
Uspješan broj nula razlikuje se od API pogreške. Provjerite status.code i status.msg kao i HTTP status. Smatrajte tajmaut ili neuspješno pretraživanje nepoznatom dostupnošću i pokušajte ponovo kasnije uz postupno odgađanje.
Zahtjev
Koristite vjerodajnice svog omogućenog API računa putem HTTPS-a. Podržani su Basic autentifikacija i bearer tokeni omogućenih API računa; primjenjuju se ograničenja računa.
GET s identifikatorom prefiksa u putanji URL-a. Nema dokumentiranih parametara upita ni tijela zahtjeva.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Naziv | Tip | Obavezno | Opis |
|---|---|---|---|
prefix_id | string | Da | Kopirajte pojedinačni ID prefiksa iz odgovora otkrivanja. Koristite podržani NANPA mobilni prefiks koji sadrži pozivni broj područja (NPA) i centralu (NXX), a ne ID samo s pozivnim brojem područja ili grupirani sažeti ID. Smatrajte identifikator neprozirnim. |
Odgovor
Provjerite status.code u JSON tijelu kao i HTTP status. Uspješan response ima status.code 200 i status.msg Results. response je objekt, a ne popis: count je cjelobrojna snimka zalihe; npa i nxx nizovi su od tri znaka. status.results nije prisutan za ovaj asocijativni objekt. Broj 0 znači da pretraživanje pokrivenosti nije pronašlo odgovarajuću centralu ili je vratilo nultu zalihu; to ne dokazuje da svi dobavljači ili druge rute otkrivanja nemaju brojeve.
Ilustrativni oblik odgovora; nisu to stvarni podaci računa ni trenutačna ponuda.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Pogreške
- 404: Pružatelj je onemogućen: pokrivenost mobilne zalihe nije dostupna na servisu.
- 404: Nevažeći ID prefiksa: nabavite trenutačni pojedinačni ID prefiksa iz otkrivanja.
- 404: Nevažeći prefiks: pohranjeni prefiks ne sadrži dovoljno znamenki za NPA/NXX pretraživanje.
- 500: Pokrivenost zalihe nije uspjela: uzvodno pretraživanje nije vratilo uspješan rezultat pokrivenosti. Pokušajte ponovo kasnije uz postupno odgađanje; neuspjeh nije broj zalihe nula.
Dostupnost i nuspojave
- Operacija provjerava zalihu i ne izdaje narudžbu, ne rezervira brojeve i ne tereti iznos kupnje.
- Zaliha se može promijeniti odmah. Broj pokrivenosti nije prilagođen kako bi obećao mogućnost kupnje specifičnu za račun ili istu duljinu kao sljedeći odgovor pretraživanja brojeva.
- Pretraživanje kontaktira servis pokrivenosti i može potrajati. Ne ispitujte više puta svaki prefiks i ne smatrajte tajmaut ili pogrešku uspješnom nultom zalihom.