Kontrollér beholdningen af mobilnumre for en central

Vælg et understøttet præfiks

Brug et aktuelt individuelt mobilpræfiks fra discovery. Dette endpoint er beregnet til NANPA-centraler: en NPA identificerer områdekoden, og en NXX identificerer centralen. Et præfiks med kun et områdenummer er for bredt. Send ikke grupperede visnings-ID'er, og udled ikke understøttelse af et andet land, fordi dets præfiks indeholder nok cifre.

Brug optællingen som et fingerpeg

Læs response.count, med response.npa og response.nxx der identificerer centralen. Dette er et øjebliksbillede fra dækningstjenesten, ikke lager holdt for din konto. Bekræft faktiske numre, gældende tilbud og eventuelle registreringskrav, før du bestiller. En vellykket optælling godkender aldrig et køb.

Skeln mellem nul lager og et mislykket opslag

En vellykket optælling på nul er forskellig fra en API-fejl. Undersøg status.code og status.msg samt HTTP-statussen. Behandl en timeout eller et mislykket opslag som ukendt tilgængelighed, og prøv igen senere med backoff.

Anmodning

Brug loginoplysningerne til din aktiverede API-konto via HTTPS. Basic-autentificering og bearer-tokens til aktiverede API-konti understøttes; kontobegrænsninger gælder.

GET med præfiksidentifikatoren i URL-stien. Der er ingen dokumenterede query- eller bodyparametre.

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

Svar

Tjek status.code i JSON-bodyen samt HTTP-statussen. Et vellykket response har status.code 200 og status.msg Results. response er et objekt, ikke en liste: count er et øjebliksbillede af lageret som heltal; npa og nxx er strenge på tre tegn. status.results er ikke til stede for dette associative objekt. En optælling på 0 betyder, at dækningsopslaget ikke fandt en matchende central eller returnerede nul lager; det beviser ikke, at alle leverandører eller andre discovery-ruter ikke har numre.

Illustrativt svarformat; ikke live kontodata og ikke en aktuel pris.

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

Fejl

• 404: Udbyder deaktiveret: dækning af beholdningen af mobilnumre er ikke tilgængelig på tjenesten.
• 404: Ugyldigt præfiks-ID: hent et aktuelt individuelt præfiks-ID fra discovery.
• 404: Ugyldigt præfiks: det gemte præfiks indeholder ikke nok cifre til et NPA/NXX-opslag.
• 500: Lagerdækning mislykkedes: opslaget hos upstream returnerede ikke et vellykket dækningsresultat. Prøv igen senere med backoff; en fejl er ikke en lageroptælling på nul.

Tilgængelighed og bivirkninger

• Handlingen kontrollerer lageret og afgiver ikke en ordre, reserverer ikke numre og trækker ikke et købsbeløb.
• Lager kan ændre sig med det samme. Dækningsoptællingen er ikke justeret til at love kontospecifik købsmulighed eller samme længde som svaret fra den næste nummersøgning.
• Et opslag kontakter dækningstjenesten og kan tage tid. Foretag ikke gentagen polling af hvert præfiks, og behandl ikke en timeout/fejl som vellykket nul lager.