Zgjidhni një parashtesë të mbështetur
Përdorni një parashtesë celulare individuale aktuale nga zbulimi. Kjo pikë fundore është menduar për sentralët NANPA: një NPA identifikon kodin e zonës dhe një NXX identifikon sentralin. Një parashtesë vetëm me kod zone është shumë e gjerë. Mos dërgoni ID të grupuara pamjeje dhe mos nxirrni përfundimin se një vend tjetër mbështetet vetëm sepse parashtesa e tij përmban shifra të mjaftueshme.
Përdorni numërimin si një tregues orientues
Lexoni response.count, me response.npa dhe response.nxx që identifikojnë sentralin. Kjo është një pamje e çastit e shërbimit të mbulimit, jo stok i mbajtur për llogarinë tuaj. Konfirmoni numrat aktualë, ofertat e zbatueshme të çmimeve dhe çdo kërkesë regjistrimi përpara porositjes. Një numërim i suksesshëm nuk autorizon kurrë një blerje.
Dalloni stokun zero nga një kërkim i dështuar
Një numërim i suksesshëm me zero ndryshon nga një gabim API. Inspektoni status.code dhe status.msg si dhe statusin HTTP. Trajtoni një skadencë kohore ose një kërkim të dështuar si disponibilitet të panjohur dhe riprovoni më vonë me pritje graduale (backoff).
Kërkesa
Përdorni kredencialet e llogarisë suaj API të aktivizuar përmes HTTPS. Autentikimi Basic dhe token-at bearer të llogarisë API të aktivizuar mbështeten; zbatohen kufizimet e llogarisë.
GET me identifikuesin e parashtesës në rrugën e URL. Nuk ka parametra query ose trupi të dokumentuar.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Emri | Tipi | I detyrueshëm | Përshkrimi |
|---|---|---|---|
prefix_id | string | Po | Kopjoni ID-në individuale të parashtesës nga përgjigja e zbulimit. Përdorni një parashtesë celulare NANPA të mbështetur që përmban një kod zone (NPA) dhe një sentral (NXX), jo një ID vetëm me kod zone ose një ID përmbledhjeje të grupuar. Trajtojeni identifikuesin si një vlerë të errët (opaque). |
Përgjigja
Kontrolloni status.code në trupin JSON si dhe statusin HTTP. Një response i suksesshëm ka status.code 200 dhe status.msg Results. response është një objekt, jo një listë: count është një foto e inventarit me numër të plotë; npa dhe nxx janë vargje me tri karaktere. status.results nuk është i pranishëm për këtë objekt shoqërues. Një numërim 0 do të thotë se kërkimi i mbulimit nuk gjeti sentral përputhës ose ktheu stok zero; nuk provon se të gjithë furnizuesit ose rrugët e tjera të zbulimit nuk kanë numra.
Formë ilustruese e përgjigjes; jo të dhëna reale llogarie dhe jo ofertë aktuale çmimi.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Gabimet
- 404: Furnizuesi i çaktivizuar: mbulimi i inventarit celular nuk është i disponueshëm në shërbim.
- 404: ID parashtese e pavlefshme: merrni një ID individuale aktuale parashtese nga zbulimi.
- 404: Parashtesë e pavlefshme: parashtesa e ruajtur nuk përmban shifra të mjaftueshme për një kërkim NPA/NXX.
- 500: Dështoi mbulimi i inventarit: kërkimi në burim nuk ktheu një rezultat mbulimi të suksesshëm. Riprovoni më vonë me pritje graduale (backoff); një dështim nuk është numërim stoku zero.
Disponibiliteti dhe efektet anësore
- Operacioni kontrollon inventarin dhe nuk vendos porosi, nuk rezervon numra dhe nuk debiton një shumë blerjeje.
- Stoku mund të ndryshojë menjëherë. Numërimi i mbulimit nuk rregullohet për të premtuar blerje specifike për llogarinë ose të njëjtën gjatësi me përgjigjen e ardhshme të kërkimit të numrave.
- Një kërkim kontakton shërbimin e mbulimit dhe mund të marrë kohë. Mos pyetni në mënyrë të përsëritur për çdo parashtesë dhe mos trajtoni një skadencë kohore ose gabim si stok zero të suksesshëm.