Pasirinkite palaikomą prefiksą
Naudokite dabartinį atskirą mobiliojo ryšio prefiksą iš atradimo. Šis galinis taškas skirtas NANPA stotims: NPA nurodo zonų kodą, o NXX – stotį. Vien tik zonų kodo prefiksas yra per platus. Nesiųskite sugrupuotų rodymo ID ir nedarykite išvados, kad kita šalis palaikoma tik todėl, kad jos prefikse pakanka skaitmenų.
Naudokite skaičių kaip užuominą
Skaitykite response.count, kur response.npa ir response.nxx identifikuoja stotį. Tai aprėpties paslaugos momentinė kopija, o ne jūsų sąskaitai laikomos atsargos. Prieš užsisakydami patvirtinkite faktinius numerius, taikomus pasiūlymus ir galimus registracijos reikalavimus. Sėkmingas skaičiavimas niekada nesuteikia pirkimo įgaliojimo.
Atskirkite nulines atsargas nuo nepavykusios užklausos
Sėkmingas nulinis skaičiavimas skiriasi nuo API klaidos. Patikrinkite status.code ir status.msg bei HTTP būseną. Laikykite pasibaigusį laiką arba nepavykusią užklausą nežinomu pasiekiamumu ir pakartokite vėliau didėjančiomis pauzėmis (backoff).
Užklausa
Naudokite aktyvintos API paskyros prisijungimo duomenis per HTTPS. Palaikomas Basic autentifikavimas ir aktyvintų API paskyrų Bearer žetonai; taikomi paskyros apribojimai.
GET su prefikso identifikatoriumi URL kelyje. Dokumentuotų užklausos eilutės arba turinio parametrų nėra.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Pavadinimas | Tipas | Privalomas | Aprašymas |
|---|---|---|---|
prefix_id | string | Taip | Nukopijuokite iš atradimo atsakymo atskirą prefikso ID. Naudokite palaikomą NANPA mobiliojo ryšio prefiksą, kuriame yra zonų kodas (NPA) ir stotis (NXX), o ne vien tik zonų kodo arba sugrupuotos santraukos ID. Laikykite identifikatorių nepermatomu. |
Atsakymas
Patikrinkite status.code JSON turinyje bei HTTP būseną. Sėkmingas response turi status.code 200 ir status.msg Results. response yra objektas, o ne sąrašas: count yra sveikasis skaičius – atsargų momentinė kopija; npa ir nxx yra trijų simbolių eilutės. Šiame asociatyviniame objekte status.results nėra. Skaičiavimas 0 reiškia, kad aprėpties užklausa nerado atitinkamos stoties arba grąžino nulines atsargas; tai neįrodo, kad visi tiekėjai ar kiti atradimo maršrutai neturi numerių.
Iliustratyvus atsakymo pavidalas; tai nėra tikri sąskaitos duomenys ar dabartinis pasiūlymas.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Klaidos
- 404: Tiekėjas išjungtas: mobiliojo ryšio atsargų aprėptis paslaugoje neprieinama.
- 404: Netinkamas prefikso ID: gaukite dabartinį atskirą prefikso ID iš atradimo.
- 404: Netinkamas prefiksas: įrašytame prefikse nepakanka skaitmenų NPA/NXX užklausai.
- 500: Atsargų aprėptis nepavyko: aukštesnės grandies užklausa negrąžino sėkmingo aprėpties rezultato. Bandykite vėliau iš naujo didėjančiomis pauzėmis (backoff); nesėkmė nėra nulinių atsargų skaičiavimas.
Pasiekiamumas ir šalutinis poveikis
- Operacija tikrina atsargas ir nekuria užsakymo, nerezervuoja numerių ir nenurašo pirkimo sumos.
- Atsargos gali pasikeisti nedelsiant. Aprėpties skaičiavimas nėra koreguojamas taip, kad pažadėtų konkrečiai sąskaitai būdingą įsigyjamumą arba tokį patį ilgį, kaip kito numerių paieškos atsakymo.
- Užklausa kreipiasi į aprėpties paslaugą ir gali užtrukti. Neapklausinėkite pakartotinai kiekvieno prefikso ir nelaikykite pasibaigusio laiko ar klaidos sėkmingu nulinių atsargų rezultatu.