Valitse tuettu etuliite
Käytä hakulöydöksistä saatavaa ajankohtaista yksittäistä mobiilietuliitettä. Tämä päätepiste on tarkoitettu NANPA-puhelinkeskuksia varten: NPA tunnistaa suuntanumeron ja NXX puhelinkeskuksen. Pelkkään suuntanumeroon rajoittuva etuliite on liian laaja. Älä lähetä ryhmiteltyjä näyttötunnuksia äläkä pätele toisen maan tukea siitä, että sen etuliitteessä on riittävästi numeroita.
Käytä lukumäärää vain vihjeenä
Lue response.count, jossa response.npa ja response.nxx tunnistavat puhelinkeskuksen. Tämä on kattavuuspalvelun tilannekuva, ei tilillesi pidettyä varastoa. Varmista todelliset numerot, sovellettavat hinnat ja mahdolliset rekisteröintivaatimukset ennen tilaamista. Onnistunut lukumäärä ei koskaan valtuuta ostoa.
Erota nollavarasto epäonnistuneesta hausta
Onnistunut nollaan yhtyvä lukumäärä eroaa API-virheestä. Tarkista status.code ja status.msg sekä HTTP-tila. Käsittele aikakatkaisua tai epäonnistunutta hakua tuntemattomana saatavuutena ja odota ennen myöhempää uutta yritystä (backoff).
Pyyntö
Käytä käytössä olevan API-tilisi tunnistetietoja HTTPS-yhteyden kautta. Basic-todennusta ja käytössä olevien API-tilien Bearer-tokeneita tuetaan; tilikohtaiset rajoitukset ovat voimassa.
GET-pyyntö, jossa etuliitteen tunniste on URL-polussa. Dokumentoituja kysely- tai runkoparametreja ei ole.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
prefix_id | string | Kyllä | Kopioi yksittäisen etuliitteen tunniste hakulöydösvastauksesta. Käytä tuettua NANPA-mobiilietuliitettä, joka sisältää suuntanumeron (NPA) ja puhelinkeskuksen (NXX), ei pelkkään suuntanumeroon rajoittuvaa tai ryhmiteltyä yhteenvetotunnusta. Käsittele tunnistetta läpinäkymättömänä. |
Vastaus
Tarkista status.code JSON-rungosta sekä HTTP-tila. Onnistuneessa response-vastauksessa on status.code 200 ja status.msg Results. response on objekti, ei lista: count on kokonaislukumuotoinen varastotilannekuva; npa ja nxx ovat kolmen merkin merkkijonoja. status.results ei ole läsnä tässä assosiatiivisessa objektissa. Lukumäärä 0 tarkoittaa, ettei kattavuushaku löytänyt vastaavaa puhelinkeskusta tai se palautti nollavaraston; se ei todista, että kaikilla toimittajilla tai muilla hakureiteillä ei olisi numeroita.
Esimerkinomainen vastauksen rakenne; ei todellisia tilitietoja eikä ajantasaista hintatarjousta.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Virheet
- 404: Palveluntarjoaja poistettu käytöstä: mobiilivarastojen kattavuus ei ole käytettävissä palvelussa.
- 404: Virheellinen etuliitetunnus: hanki ajankohtainen yksittäinen etuliitetunnus hakulöydöksistä.
- 404: Virheellinen etuliite: tallennettu etuliite ei sisällä riittävästi numeroita NPA/NXX-hakuun.
- 500: Varastokattavuus epäonnistui: ylävirran haku ei palauttanut onnistunutta kattavuustulosta. Odota ennen kuin yrität myöhemmin uudelleen (backoff); epäonnistuminen ei ole nollaa osoittava varastolukumäärä.
Saatavuus ja sivuvaikutukset
- Toiminto tarkistaa varaston eikä tee tilausta, varaa numeroita eikä veloita ostosummaa.
- Varasto voi muuttua heti. Kattavuuslukumäärää ei soviteta lupaamaan tilikohtaista ostettavuutta tai samaa pituutta kuin seuraavan numerohaun vastaus.
- Haku ottaa yhteyden kattavuuspalveluun ja voi viedä aikaa. Älä kysele toistuvasti jokaista etuliitettä äläkä käsittele aikakatkaisua tai virhettä onnistuneena nollavarastona.