Bekreft at mobilbeholdning er aktivert
Bruk dette søket først etter at mobilnummerbeholdning er aktivert for kundekontoen din. Skaff et gjeldende individuelt mobilprefiks gjennom kontoens discovery-arbeidsflyt. Den støttede stien ber om trådløs beholdning for det prefikset. Den avhenger ikke av en samsvarende rutingmetadatapost for fastlinje. Kontakt kundestøtte hvis du er usikker på om kontoen eller prefikset ditt er aktivert.
Den nåværende eldre ruten avviser ikke pålitelig hver forespørsel som ikke kvalifiserer. En konto uten aktivert mobilbeholdning kan motta ordinær beholdning mens svaret fortsatt sier info.is_mobile: 1. Et gratisprefiks kan også nå grenen for gratisbeholdning med den etiketten. Ikke bruk denne etiketten alene for å identifisere mobiltjeneste, og ikke send ordinære eller gratisprefikser til dette endepunktet. Bruk kontoens bekreftede mobilkatalog og aktiverte arbeidsflyt.
Behold hvert nummer sammen med sitt eget prisvalg
Behold for hver kandidat number, info.uuid og samme oppførings price-liste sammen. Svaret inneholder også metadata for prefiks/område/land, kontraktsvilkår og registreringsbegrensninger. Kandidatene sorteres etter månedsprisen til sitt første prisvalg, stigende; det finnes ingen garantert stabil rekkefølge for like priser. Ikke bytt ut det returnerte nummer-ID-et med et område- eller prefiks-ID, og ikke kombiner det med en annen kandidats pris-ID.
Det fullstendige svaret kan inneholde ytterligere metadata- og prisfelt. Returnerte features, kanalverdier og restrictions beskriver kandidaten; de er ingen garanti for at samtaler, SMS, MMS eller faks allerede er brukbare. Kontotillatelser, registrering og det valgte tjenesteabonnementet gjelder fortsatt. Ikke behandle eksempelets plassholdere som gyldige ID-er eller priser.
Bruk en liten positiv mengde
Begynn med en mengde på 1. Den normale leverandørforespørselen normaliserer en ikke-positiv mengde til 1 og begrenser oppstrømsverdien til 300, men senere resultathåndtering bruker fortsatt den opprinnelige inndataverdien. En mengde på null kan derfor be om oppstrømsbeholdning og returnere ingen kandidater. Andre eldre grener håndhever ikke konsekvent det forespurte resultatantallet. Ikke stol på ett enkelt universelt maksimum, og ikke send negative, fraksjonelle eller ikke-numeriske verdier. Ingen støttet offentlig søkefilter- eller pris-ID-kroppparameter er dokumentert for denne ruten.
Skill manglende beholdning fra oppslagsfeil
Et 404-svar kan representere utilgjengelig beholdning, deaktivert tjeneste, mislykket leverandøroppslag eller ugyldige katalogoppføringer. Behandle et tidsavbrudd eller en leverandørfeil som ukjent tilgjengelighet i stedet for bekreftet nullbeholdning. Oppdater utvalget og prøv på nytt med backoff når det er passende. Unngå å spørre hver telefonsentral gjentatte ganger. Det separate endepunktet for mobilbeholdningsantall er et øyeblikksbildehint og trenger ikke å samsvare med lengden på denne kontoens kandidatliste.
Kontroller på nytt før kjøp
Søk reserverer ikke beholdning. Den gjennomgåtte grenen forsøker å ekskludere numre som allerede er kjøpt, men et mislykket lokalt reservasjonsoppslag kan la en slik kandidat bli stående i resultatet. Tilgjengelighet, eierskap, godkjent prising og registrering må kontrolleres av kjøpsarbeidsflyten. Bruk et ferskt utvalg med den beskyttede kjøpsforespørselen, og avstem kontobeholdningen etter et usikkert kjøpsresultat før du prøver på nytt. Kjøp aldri kun fordi en kandidat ble returnert.
Forespørsel
Bruk en aktivert API-konto over HTTPS fra en tillatt kilde-IP-adresse. Mobilbeholdning må også være aktivert for kundekontoen; API-autentisering alene aktiverer den ikke.
GET med den gjeldende individuelle prefiksidentifikatoren og en positiv heltallsmengde i URL-stien. Mengden er standard 1 hvis den utelates. Bruk eksempelet med 1; denne ruten validerer eller håndhever ikke konsekvent en universell resultatgrense.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
prefix_id | string | Ja | Den ugjennomsiktige synlige ID-en til et kvalifisert individuelt mobilprefiks fra discovery. Bruk et mobilt NPA/NXX-prefiks for en telefonsentral som støttes av kontoen din; ikke erstatt med et område-ID, gruppert visnings-ID, bokstavelig ringeprefiks eller gratisprefiks. |
quantity | integer | Nei | Forespurt antall kandidater. Standard er 1. Oppgi et beskjedent positivt heltall. Den normale oppstrømsforespørselen begrenser mengden til 300, men det er ikke et universelt validert inndata eller en garanti for svarstørrelse. |
Svar
Inspiser status.code og status.msg i JSON-kroppen i tillegg til HTTP-status. Ved suksess er response en liste over nummerkandidater, status.msg er Results: etterfulgt av antallet returnert, og status.results er den serialiserte listelengden. Kandidatpriser er kontospesifikke. Det illustrative forkortede eksempelet bruker plassholdere i stedet for ekte beholdning eller et tarifftilbud. Numre inneholder landkoden uten plusstegn; identifikatorer er ugjennomsiktige strenger.
Illustrativ svarform; ikke live kontodata eller et gjeldende pristilbud.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Feil
- 404: Ugyldig prefiks-ID, land eller område: oppdater utvalget av individuelle mobilprefikser.
- 404: Ingen numre funnet: kan bety ingen brukbar beholdning, deaktivert tjeneste, mislykket leverandøroppslag, ustøttet utvalg eller kontobegrensninger. Det er ikke bevis på et autoritativt beholdningsantall på null.
Tilgjengelighet og bivirkninger
- Søk leier eller reserverer ikke et nummer, og den gjennomgåtte stien belaster ikke et kjøpsbeløp. Den kontakter beholdningsleverandøren og kan ta tid.
- Vellykkede søk skriver kontorelaterte nummer- og prishurtigbufferoppføringer og spørringslogger. Å gjenta et søk er ikke en reservasjon, prislås eller kjøp.
- De returnerte prisene, vilkårene, begrensningene og funksjonene må gjennomgås for den valgte kontoen og nummeret. En funksjonsetikett etablerer ikke aktivering, meldingsgodkjenning eller testet tjenestefunksjonalitet.