Controleer mobiele voorraad voor een centrale

Kies een ondersteund prefix

Gebruik een actueel individueel mobiel prefix uit de discovery. Dit endpoint is bedoeld voor NANPA-centrales: een NPA identificeert het netnummer en een NXX identificeert de centrale. Een prefix met alleen een netnummer is te breed. Stuur geen gegroepeerde weergave-ID's en leid niet af dat een ander land wordt ondersteund omdat het prefix van dat land voldoende cijfers bevat.

Gebruik de telling als aanwijzing

Lees response.count, met response.npa en response.nxx die de centrale identificeren. Dit is een momentopname van de dekkingsservice, geen voorraad die voor jouw account wordt vastgehouden. Bevestig de werkelijke nummers, geldende offertes en eventuele registratievereisten voordat je bestelt. Een geslaagde telling autoriseert nooit een aankoop.

Onderscheid nulvoorraad van een mislukte opzoeking

Een geslaagde telling van nul verschilt van een API-fout. Controleer status.code en status.msg en ook de HTTP-status. Behandel een timeout of mislukte opzoeking als onbekende beschikbaarheid en probeer het later opnieuw met backoff.

Verzoek

Gebruik de aanmeldingsgegevens van je ingeschakelde API-account via HTTPS. Basic-authenticatie en bearer-tokens van ingeschakelde API-accounts worden ondersteund; accountbeperkingen zijn van toepassing.

GET met de prefixidentificator in het URL-pad. Er zijn geen gedocumenteerde query- of bodyparameters.

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

Antwoord

Controleer status.code in de JSON-body en ook de HTTP-status. Een geslaagde response heeft status.code 200 en status.msg Results. response is een object, geen lijst: count is een momentopname van de voorraad als geheel getal; npa en nxx zijn strings van drie tekens. status.results is niet aanwezig voor dit associatieve object. Een telling van 0 betekent dat de dekkingsopzoeking geen bijpassende centrale vond of nulvoorraad terugmeldde; het bewijst niet dat alle leveranciers of andere discovery-routes geen nummers hebben.

Illustratieve antwoordvorm; geen live accountgegevens en geen actuele offerte.

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

Fouten

• 404: Provider uitgeschakeld: dekking van mobiele voorraad is niet beschikbaar op de service.
• 404: Ongeldig prefix-ID: verkrijg een actueel individueel prefix-ID uit de discovery.
• 404: Ongeldig prefix: het opgeslagen prefix bevat niet genoeg cijfers voor een NPA/NXX-opzoeking.
• 500: Voorraaddekking mislukt: de opzoeking bij de upstream gaf geen geslaagd dekkingsresultaat terug. Probeer het later opnieuw met backoff; een fout is geen voorraadtelling van nul.

Beschikbaarheid en bijwerkingen

• De bewerking controleert de voorraad en plaatst geen bestelling, reserveert geen nummers en schrijft geen aankoopbedrag af.
• Voorraad kan onmiddellijk veranderen. De dekkingstelling is niet aangepast om accountspecifieke koopbaarheid of dezelfde lengte als het antwoord van de volgende nummerzoeking te beloven.
• Een opzoeking neemt contact op met de dekkingsservice en kan tijd kosten. Poll niet herhaaldelijk elk prefix en behandel een timeout/fout niet als geslaagde nulvoorraad.