Izvēlieties atbalstītu priedēkli
Izmantojiet pašreizēju atsevišķu mobilo priedēkli no atklāšanas. Šis galapunkts ir paredzēts NANPA telefona centrālēm: NPA apzīmē apgabala kodu, un NXX apzīmē centrāli. Tikai apgabala kodu saturošs priedēklis ir pārāk plašs. Nesūtiet grupētus attēlojuma ID un neslēdziet, ka cita valsts ir atbalstīta tāpēc, ka tās priedēklī ir pietiekami daudz ciparu.
Izmantojiet skaitu kā norādi
Izlasiet response.count, kur response.npa un response.nxx identificē centrāli. Šis ir seguma pakalpojuma momentuzņēmums, nevis jūsu kontam turēts krājums. Apstipriniet faktiskos numurus, piemērojamos piedāvājumus un jebkādas reģistrācijas prasības pirms pasūtīšanas. Veiksmīgs skaits nekad neatļauj pirkumu.
Atšķiriet nulles krājumu no neveiksmīga vaicājuma
Veiksmīgs nulles skaits atšķiras no API kļūdas. Pārbaudiet status.code un status.msg kā arī HTTP statusu. Uztveriet noildzi vai neveiksmīgu vaicājumu kā nezināmu pieejamību un mēģiniet vēlāk atkārtoti ar aizkaves pieaugumu.
Pieprasījums
Izmantojiet savus aktivizētos API konta akreditācijas datus pār HTTPS. Basic autentifikācija un aktivizēto API kontu nesēja marķieri ir atbalstīti; attiecas konta ierobežojumi.
GET ar priedēkļa identifikatoru URL ceļā. Dokumentētu vaicājuma vai pamatteksta parametru nav.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nosaukums | Tips | Obligāts | Apraksts |
|---|---|---|---|
prefix_id | string | Jā | Nokopējiet atsevišķa priedēkļa ID no atklāšanas atbildes. Izmantojiet atbalstītu NANPA mobilo priedēkli, kas satur apgabala kodu (NPA) un centrāli (NXX), nevis tikai apgabala kodu vai grupētas kopsavilkuma ID. Uztveriet identifikatoru kā necaurspīdīgu. |
Atbilde
Pārbaudiet status.code JSON pamattekstā kā arī HTTP statusu. Veiksmīgai response atbildei ir status.code 200 un status.msg Results. response ir objekts, nevis saraksts: count ir vesela skaitļa krājuma momentuzņēmums; npa un nxx ir trīs zīmju virknes. status.results šim asociatīvajam objektam nav pieejams. Skaits 0 nozīmē, ka seguma vaicājums neatrada atbilstošu centrāli vai atgrieza nulles krājumu; tas nepierāda, ka visiem piegādātājiem vai citiem atklāšanas maršrutiem nav numuru.
Ilustratīvs atbildes formāts; nevis dzīvi konta dati vai pašreizējs piedāvājums.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Kļūdas
- 404: Pakalpojuma sniedzējs atspējots: mobilo krājumu segums pakalpojumā nav pieejams.
- 404: Nederīgs priedēkļa ID: iegūstiet pašreizēju atsevišķu priedēkļa ID no atklāšanas.
- 404: Nederīgs priedēklis: glabātais priedēklis nesatur pietiekami daudz ciparu NPA/NXX vaicājumam.
- 500: Krājumu segums neizdevās: augšupstraumes vaicājums neatgrieza veiksmīgu seguma rezultātu. Mēģiniet vēlāk atkārtoti ar aizkaves pieaugumu; neveiksme nav nulles krājumu skaits.
Pieejamība un blakusefekti
- Darbība pārbauda krājumu un neizveido pasūtījumu, nerezervē numurus un neatskaita pirkuma summu.
- Krājums var mainīties nekavējoties. Seguma skaits nav pielāgots, lai solītu kontam specifisku iegādājamību vai to pašu garumu kā nākamās numuru meklēšanas atbilde.
- Vaicājums sazinās ar seguma pakalpojumu un var aizņemt laiku. Neaptaujojiet atkārtoti katru priedēkli un neuztveriet noildzi vai kļūdu kā veiksmīgu nulles krājumu.