Kontroleer mobiele voorraad vir 'n sentrale

Kies 'n ondersteunde voorvoegsel

Gebruik 'n huidige individuele mobiele voorvoegsel vanaf ontdekking. Dié eindpunt is bedoel vir NANPA-sentrales: 'n NPA identifiseer die areakode, en 'n NXX identifiseer die sentrale. 'n Voorvoegsel met slegs 'n areakode is te breed. Stuur nie gegroepeerde vertoon-ID's nie, en moenie ondersteuning vir 'n ander land aflei net omdat sy voorvoegsel genoeg syfers bevat nie.

Gebruik die telling as 'n wenk

Lees response.count, met response.npa en response.nxx wat die sentrale identifiseer. Dit is die dekkingsdiens se momentopname, nie voorraad wat vir jou rekening aangehou word nie. Bevestig werklike nommers, toepaslike kwotasies en enige registrasievereistes voordat jy bestel. 'n Suksesvolle telling magtig nooit 'n aankoop nie.

Onderskei nul-voorraad van 'n mislukte opsoek

'n Suksesvolle telling van nul verskil van 'n API-fout. Inspekteer status.code en status.msg asook die HTTP-status. Hanteer 'n tydverstryking of 'n mislukte opsoek as onbekende beskikbaarheid en probeer later weer met toenemende wagtye.

Aanvraag

Gebruik jou geaktiveerde API-rekening se geloofsbriewe oor HTTPS. Basic-outentisering en geaktiveerde API-rekening draertokens word ondersteun; rekeningbeperkings geld.

GET met die voorvoegsel-identifiseerder in die URL-pad. Daar is geen gedokumenteerde navraag- of liggaamparameters nie.

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

Respons

Kontroleer status.code in die JSON-liggaam asook die HTTP-status. 'n Suksesvolle response het status.code 200 en status.msg Results. response is 'n objek, nie 'n lys nie: count is 'n heelgetal-voorraadmomentopname; npa en nxx is driekarakter-strings. status.results is nie teenwoordig vir hierdie assosiatiewe objek nie. 'n Telling van 0 beteken dat die dekkingsopsoek geen passende sentrale gehad het of nul-voorraad teruggegee het; dit bewys nie dat alle verskaffers of ander ontdekkingsroetes geen nommers het nie.

Illustratiewe responsvorm; nie werklike rekeningdata of 'n huidige kwotasie nie.

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

Foute

• 404: Verskaffer gedeaktiveer: mobiele voorraaddekking is nie op die diens beskikbaar nie.
• 404: Ongeldige voorvoegsel-ID: verkry 'n huidige individuele voorvoegsel-ID vanaf ontdekking.
• 404: Ongeldige voorvoegsel: die gestoorde voorvoegsel bevat nie genoeg syfers vir 'n NPA/NXX-opsoek nie.
• 500: Voorraaddekking het misluk: die stroomop-opsoek het nie 'n suksesvolle dekkingsresultaat teruggegee nie. Probeer later weer met toenemende wagtye; 'n mislukking is nie 'n voorraadtelling van nul nie.

Beskikbaarheid en newe-effekte

• Die operasie kontroleer voorraad en plaas nie 'n bestelling nie, reserveer nie nommers nie en debiteer nie 'n aankoopbedrag nie.
• Voorraad kan onmiddellik verander. Die dekkingstelling word nie aangepas om rekening-spesifieke koopbaarheid of dieselfde lengte as die volgende nommersoek-respons te belowe nie.
• 'n Opsoek kontak die dekkingsdiens en kan tyd neem. Poll nie herhaaldelik elke voorvoegsel nie, en hanteer 'n tydverstryking/fout nie as suksesvolle nul-voorraad nie.