Velg et støttet prefiks
Bruk et oppdatert individuelt mobilprefiks fra discovery. Dette endepunktet er ment for NANPA-telefonsentraler: en NPA identifiserer områdekoden, og en NXX identifiserer telefonsentralen. Et prefiks med kun områdekode er for bredt. Ikke send grupperte visnings-ID-er, og anta ikke støtte for et annet land fordi prefikset inneholder tilstrekkelig antall siffer.
Bruk antallet som et hint
Les response.count, med response.npa og response.nxx som identifiserer telefonsentralen. Dette er dekningstjenestens øyeblikksbilde, ikke lager holdt for kontoen din. Bekreft faktiske numre, aktuelle pristilbud og eventuelle registreringskrav før du bestiller. Et vellykket antall gir aldri tillatelse til et kjøp.
Skill mellom tomt lager og et mislykket oppslag
Et vellykket antall på null skiller seg fra en API-feil. Undersøk status.code og status.msg i tillegg til HTTP-statusen. Behandle et tidsavbrudd eller et mislykket oppslag som ukjent tilgjengelighet, og prøv igjen senere med backoff.
Forespørsel
Bruk dine aktiverte API-kontolegitimasjoner over HTTPS. Basic-autentisering og bærertokener for aktiverte API-kontoer støttes; kontobegrensninger gjelder.
GET med prefiksidentifikatoren i URL-stien. Det finnes ingen dokumenterte spørre- eller kroppsparametere.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
prefix_id | string | Ja | Kopier den individuelle prefiks-ID-en fra discovery-svaret. Bruk et støttet NANPA-mobilprefiks som inneholder en områdekode (NPA) og en telefonsentral (NXX), ikke en ID med kun områdekode eller en gruppert sammendrags-ID. Behandle identifikatoren som ugjennomsiktig. |
Svar
Sjekk status.code i JSON-kroppen i tillegg til HTTP-statusen. Et vellykket response har status.code 200 og status.msg Results. response er et objekt, ikke en liste: count er et heltallig øyeblikksbilde av lageret; npa og nxx er tegnstrenger på tre tegn. status.results er ikke til stede for dette assosiative objektet. Et antall på 0 betyr at dekningsoppslaget ikke hadde noen samsvarende telefonsentral eller returnerte tomt lager; det beviser ikke at alle leverandører eller andre discovery-ruter mangler numre.
Illustrativt svarformat; ikke live kontodata eller et aktuelt pristilbud.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Feil
- 404: Leverandør deaktivert: mobil lagerdekning er ikke tilgjengelig på tjenesten.
- 404: Ugyldig prefiks-ID: skaff en aktuell individuell prefiks-ID fra discovery.
- 404: Ugyldig prefiks: det lagrede prefikset inneholder ikke nok siffer for et NPA/NXX-oppslag.
- 500: Lagerdekning mislyktes: oppstrømsoppslaget returnerte ikke et vellykket dekningsresultat. Prøv igjen senere med backoff; en feil er ikke et lagerantall på null.
Tilgjengelighet og bivirkninger
- Operasjonen kontrollerer lageret og legger ikke inn en bestilling, reserverer ikke numre og belaster ikke noe kjøpsbeløp.
- Lageret kan endres umiddelbart. Dekningsantallet er ikke justert til å love kontospesifikk kjøpsmulighet eller samme lengde som svaret fra neste nummersøk.
- Et oppslag kontakter dekningstjenesten og kan ta tid. Ikke poll hvert prefiks gjentatte ganger, og ikke behandle et tidsavbrutt eller feilaktig oppslag som vellykket tomt lager.