Etsi käytettävissä olevia matkapuhelinnumeroita

Varmista, että matkapuhelinvarasto on käytössä

Käytä tätä hakua vasta sen jälkeen, kun matkapuhelinnumerovarasto on otettu käyttöön asiakastililläsi. Hanki ajantasainen yksittäinen matkapuhelinetuliite tilin löytämistyönkulun kautta. Tuettu polku pyytää langattoman varaston kyseiselle etuliitteelle. Se ei riipu vastaavasta lankaverkon reititystietueesta. Ota yhteyttä tukeen, jos et ole varma, onko tilisi tai etuliitteesi käytössä.

Nykyinen vanha reitti ei luotettavasti hylkää jokaista kelvotonta pyyntöä. Tili, jolla matkapuhelinvarasto ei ole käytössä, voi saada tavallista varastoa, vaikka vastaus vielä sanoo info.is_mobile: 1. Maksuton etuliite voi myös päätyä maksuttoman varaston haaraan samalla merkinnällä. Älä käytä tätä merkintää yksin matkapuhelinpalvelun tunnistamiseen, äläkä lähetä tavallisia tai maksuttomia etuliitteitä tähän päätepisteeseen. Käytä tilin vahvistettua matkapuhelinluetteloa ja käytössä olevaa työnkulkua.

Pidä jokainen numero oman hintavalintansa kanssa

Pidä jokaiselle ehdokkaalle number, info.uuid ja saman merkinnän price luettelo yhdessä. Vastaus sisältää myös etuliite-, alue- ja maatiedot, sopimusehdot ja rekisteröintirajoitukset. Ehdokkaat järjestetään ensimmäisen hintavaihtoehdon kuukausihinnan mukaan nousevassa järjestyksessä; yhtä suurille hinnoille ei taata vakaata järjestystä. Älä korvaa palautettua numeron tunnistetta alue- tai etuliitetunnisteella äläkä yhdistä sitä toisen ehdokkaan hintatunnisteeseen.

Täydellinen vastaus voi sisältää lisää metatietoja ja hintakenttiä. Palautetut features, kanava-arvot ja restrictions kuvaavat ehdokasta; ne eivät ole takaus siitä, että puhelut, SMS, MMS tai faksi ovat jo käytettävissä. Tilin käyttöoikeudet, rekisteröinti ja valittu palvelusuunnitelma vaikuttavat silti. Älä pidä esimerkin paikkamerkkejä kelvollisina tunnisteina tai hintoina.

Käytä pientä positiivista määrää

Aloita määrällä 1. Normaali palveluntarjoajapyyntö muuntaa ei-positiivisen määrän arvoksi 1 ja rajoittaa ylävirran arvon enintään 300:aan, mutta myöhempi tulosten käsittely käyttää yhä alkuperäistä syötettä. Nollamäärä voi siis pyytää ylävirran varastoa eikä palauttaa yhtään ehdokasta. Muut vanhat haarat eivät johdonmukaisesti pakota pyydettyä tulosten määrää. Älä nojaa yhteen yleiseen enimmäisarvoon äläkä lähetä negatiivisia, murtolukuisia tai ei-numeerisia arvoja. Tälle reitille ei ole dokumentoitu tuettua julkista hakusuodatinta tai hintatunnisteen runkoparametria.

Erottele varaston puuttuminen hakuvirheestä

404-vastaus voi tarkoittaa ei-saatavilla olevaa varastoa, käytöstä poistettua palvelua, epäonnistunutta toimittajahakua tai virheellisiä luettelotietueita. Käsittele aikakatkaisu tai palveluntarjoajavirhe tuntemattomana saatavuutena eikä vahvistettuna nollavarastona. Päivitä valinta ja yritä uudelleen viiveellä, kun se on asianmukaista. Vältä jokaisen puhelinkeskuksen toistuvaa kyselemistä. Erillinen matkapuhelinvaraston määrän päätepiste on tilannevedosvihje eikä sen tarvitse vastata tämän tilin ehdokasluettelon pituutta.

Tarkista uudelleen ennen ostamista

Haku ei varaa varastoa. Tarkistettu haara pyrkii sulkemaan pois jo ostetut numerot, mutta epäonnistunut paikallinen varaushaku voi jättää tällaisen ehdokkaan tulokseen. Saatavuus, omistus, hyväksytyt hinnat ja rekisteröinti on tarkistettava oston työnkulussa. Käytä tuoretta valintaa suojatun ostopyynnön kanssa ja täsmäytä tilin numerovarasto jokaisen epävarman ostotuloksen jälkeen ennen uudelleenyritystä. Älä koskaan osta vain siksi, että ehdokas palautettiin.

Pyyntö

Käytä käytössä olevaa API-tiliä HTTPS:n kautta sallitusta lähde-IP-osoitteesta. Matkapuhelinvaraston on myös oltava käytössä asiakastilillä; pelkkä API-todennus ei ota sitä käyttöön.

GET nykyisen yksittäisen etuliitetunnisteen ja positiivisen kokonaislukumäärän kanssa URL-polussa. Määrän oletus on 1, jos se jätetään pois. Käytä esimerkkiä arvolla 1; tämä reitti ei johdonmukaisesti validoi tai pakota yleistä tulosten rajaa.

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

Vastaus

Tarkista status.code ja status.msg JSON-rungosta samoin kuin HTTP-tila. Onnistumisen yhteydessä response on luettelo numeroehdokkaista, status.msg on Results:, jonka jälkeen tulee palautettujen numeroiden määrä, ja status.results on sarjoitetun luettelon pituus. Ehdokkaiden hinnat ovat tilikohtaisia. Havainnollistava lyhennetty esimerkki käyttää paikkamerkkejä todellisen varaston tai tariffitarjouksen sijaan. Numerot sisältävät maakoodin ilman plusmerkkiä; tunnisteet ovat läpinäkymättömiä merkkijonoja.

Havainnollistava vastauksen muoto; ei todellisia tilin tietoja tai ajantasaista tarjousta.

{
  "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"
      ]
    }
  ]
}

Virheet

• 404: Virheellinen etuliitetunniste, maa tai alue: päivitä yksittäisen matkapuhelinetuliitteen valinta.
• 404: Numeroita ei löytynyt: voi tarkoittaa käyttökelpoisen varaston puuttumista, käytöstä poistettua palvelua, epäonnistunutta palveluntarjoajahakua, ei-tuettua valintaa tai tilin rajoituksia. Se ei ole todiste luotettavasti vahvistetusta nollavaraston määrästä.

Saatavuus ja sivuvaikutukset

• Haku ei vuokraa tai varaa numeroa, eikä tarkistettu polku veloita ostosummaa. Se ottaa yhteyden varaston palveluntarjoajaan ja voi viedä aikaa.
• Onnistuneet haut kirjoittavat tilin numero- ja hintavälimuistimerkinnät sekä kyselylokit. Haun toistaminen ei ole varaus, hintalukitus tai osto.
• Palautetut hinnat, ehdot, rajoitukset ja ominaisuudet on tarkistettava valitun tilin ja numeron osalta. Ominaisuusmerkintä ei osoita aktivointia, viestien hyväksyntää tai testattua palvelun toimivuutta.