Leia saadaolevad mobiilinumbrid

Kinnita, et mobiilinumbrite varu on lubatud

Kasuta seda otsingut alles pärast seda, kui mobiilinumbrite varu on sinu kliendikonto jaoks lubatud. Hangi kehtiv individuaalne mobiilieesliide konto avastamise töövoo kaudu. Toetatud tee pärib selle eesliite jaoks juhtmevaba varu. See ei sõltu vastavast juhtmega marsruutimise metaandmete kirjest. Võta ühendust toega, kui sa pole kindel, kas sinu konto või eesliide on lubatud.

Praegune pärandtee ei lükka usaldusväärselt tagasi kõiki sobimatuid päringuid. Konto, millel mobiilinumbrite varu pole lubatud, võib saada tavalist varu, kuigi vastuses seisab endiselt info.is_mobile: 1. Tasuta numbri eesliide võib sama sildiga jõuda ka tasuta numbrite varu harusse. Ära kasuta seda silti üksi mobiiliteenuse tuvastamiseks ja ära saada tavalisi ega tasuta eesliiteid sellele lõpp-punktile. Kasuta konto kinnitatud mobiilikataloogi ja lubatud töövoogu.

Hoia iga number koos oma hinnavalikuga

Hoia iga kandidaadi puhul number, info.uuid ja sama kirje price nimekiri koos. Vastus sisaldab lisaks eesliite/ala/riigi metaandmeid, lepingutingimusi ja registreerimise piiranguid. Kandidaadid on sorteeritud esimese hinnavaliku kuuhinna järgi kasvavalt; võrdsete hindade puhul pole stabiilset järjekorda tagatud. Ära asenda tagastatud numbri ID ala- ega eesliite ID-ga ega ühenda seda teise kandidaadi hinna ID-ga.

Täielik vastus võib sisaldada täiendavaid metaandmeid ja hinnavälju. Tagastatud features, kanalite väärtused ja restrictions kirjeldavad kandidaati; need ei garanteeri, et kõned, SMS-id, MMS-id või faksid on juba kasutatavad. Konto õigused, registreerimine ja valitud teenuseplaan kehtivad endiselt. Ära käsitle näite kohatäiteid kehtivate ID-dena ega hindadena.

Kasuta väikest positiivset kogust

Alusta kogusega 1. Tavaline teenusepakkuja päring normaliseerib mittepositiivse koguse väärtusele 1 ja piirab ülesvoolu väärtuse 300-le, kuid hilisem tulemuste töötlemine kasutab endiselt algset sisendit. Nullkogus võib seetõttu pärida ülesvoolu varu ja mitte tagastada ühtegi kandidaati. Teised pärandharud ei jõusta nõutud tulemuste arvu järjekindlalt. Ära looda üheleainsale üldisele maksimumile ega saada negatiivseid, murd- ega mittearvulisi väärtusi. Sellele teele ei ole dokumenteeritud ühtegi toetatud avalikku otsingufiltrit ega hinna-ID päringu keha parameetrit.

Eralda puuduv varu otsingu veast

404 vastus võib tähendada kättesaamatut varu, keelatud teenust, ebaõnnestunud tarnija otsingut või vigaseid kataloogikirjeid. Käsitle ajalõppu või pakkuja tõrget teadmata saadavusena, mitte kinnitatud nullvaruna. Värskenda vajadusel valikut ja proovi kasvava viivitusega uuesti. Väldi kõigi telefonikeskjaamade korduvat küsitlemist. Eraldi mobiilivarude arvu lõpp-punkt on hetkevihje ja ei pea vastama selle konto kandidaatide loendi pikkusele.

Kontrolli uuesti enne ostmist

Otsing ei broneeri varu. Läbi vaadatud haru püüab välistada juba ostetud numbrid, kuid ebaõnnestunud kohaliku broneeringu otsing võib jätta sellise kandidaadi tulemusesse. Saadavuse, omandi, kinnitatud hinnastamise ja registreerimise peab ostu töövoog kontrollima. Kasuta kaitstud ostupäringuga värsket valikut ja vii konto varud pärast iga ebakindlat ostutulemust enne uuesti proovimist vastavusse. Ära osta kunagi ainult sellepärast, et kandidaat tagastati.

Päring

Kasuta lubatud API kontot HTTPS kaudu lubatud lähte-IP-aadressilt. Mobiilinumbrite varu peab olema ka kliendikonto jaoks lubatud; API autentimine üksi ei luba seda.

GET koos kehtiva individuaalse eesliite identifikaatori ja positiivse täisarvulise kogusega URL-i tees. Kui kogus on välja jäetud, on vaikimisi 1. Kasuta näidet numbriga 1; see tee ei valideeri ega jõusta järjekindlalt üldist tulemuste piiri.

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

Vastus

Kontrolli JSON-i kehas status.code ja status.msg samuti HTTP olekut. Edu korral on response numbrikandidaatide loend, status.msg on Results:, millele järgneb tagastatud kirjete arv, ja status.results on jadastatud loendi pikkus. Kandidaatide hinnad on kontopõhised. Illustratiivne lühendatud näide kasutab tegeliku numbrivaru või tariifi hinnapakkumise asemel kohatäiteid. Numbrid sisaldavad riigikoodi ilma plussmärgita; identifikaatorid on läbipaistmatud stringid.

Illustratiivne vastuse kuju; pole reaalsed konto andmed ega kehtiv hinnapakkumine.

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

Vead

• 404: Vigane eesliite ID, riik või ala: värskenda individuaalse mobiilieesliite valikut.
• 404: Numbreid ei leitud: võib tähendada kasutuskõlbmatut varu, keelatud teenust, ebaõnnestunud pakkuja otsingut, toetamata valikut või konto piiranguid. See pole tõend autoriteetsest nullvarude loendusest.

Saadavus ja kõrvalmõjud

• Otsing ei üüra ega broneeri numbrit ja läbi vaadatud tee ei debiteeri ostusummat. See võtab ühendust varude pakkujaga ja võib aega võtta.
• Edukad otsingud kirjutavad kontoga seotud numbri- ja hinnapuhvri kirjed ning päringulogid. Otsingu kordamine pole broneering, hinnalukk ega ost.
• Tagastatud hinnad, tingimused, piirangud ja võimalused tuleb valitud konto ja numbri jaoks üle vaadata. Funktsiooni silt ei näita aktiveerimist, sõnumside heakskiitu ega testitud teenuse funktsionaalsust.