Atrodiet pieejamos mobilos numurus

Apstipriniet, ka mobilo numuru krājumi ir iespējoti

Izmantojiet šo meklēšanu tikai pēc tam, kad jūsu klienta kontam ir iespējoti mobilo numuru krājumi. Iegūstiet pašreizējo individuālo mobilo priedēkli, izmantojot konta atklāšanas darbplūsmu. Atbalstītais ceļš pieprasa bezvadu krājumus šim priedēklim. Tas nav atkarīgs no atbilstoša vadu maršrutēšanas metadatu ieraksta. Sazinieties ar atbalsta dienestu, ja neesat pārliecināts, vai jūsu konts vai priedēklis ir iespējots.

Pašreizējais mantojuma maršruts neuzticami noraida katru neatbilstošu pieprasījumu. Konts bez iespējotiem mobilo numuru krājumiem var saņemt parastos krājumus, kamēr atbilde joprojām norāda info.is_mobile: 1. Bezmaksas priedēklis arī var nonākt bezmaksas krājumu zarā ar šādu marķējumu. Neizmantojiet šo marķējumu vienu pašu mobilā pakalpojuma identificēšanai, un nesūtiet parastos vai bezmaksas priedēkļus uz šo galapunktu. Izmantojiet konta apstiprināto mobilo katalogu un iespējoto darbplūsmu.

Katru numuru glabājiet kopā ar tā paša izvēlēto cenu

Katram kandidātam glabājiet number, info.uuid un tā paša ieraksta price sarakstu kopā. Atbilde satur arī priedēkļa, apgabala un valsts metadatus, līguma nosacījumus un reģistrācijas ierobežojumus. Kandidāti ir sakārtoti augošā secībā pēc pirmās cenas opcijas mēneša cenas; vienādām cenām nav garantēta stabila secība. Neaizstājiet atgriezto numura ID ar apgabala vai priedēkļa ID un nesavienojiet to ar cita kandidāta cenas ID.

Pilnā atbilde var ietvert papildu metadatus un cenu laukus. Atgrieztie features, kanālu vērtības un restrictions apraksta kandidātu; tie negarantē, ka zvani, īsziņas, MMS vai fakss jau ir izmantojami. Konta atļaujas, reģistrācija un atlasītais pakalpojuma plāns joprojām attiecas. Neuzskatiet piemēra vietturus par derīgiem ID vai cenām.

Izmantojiet nelielu pozitīvu daudzumu

Sāciet ar daudzumu 1. Normāls pakalpojumu sniedzēja pieprasījums normalizē nepozitīvu daudzumu uz 1 un ierobežo augšupējo vērtību līdz 300, bet vēlākā rezultātu apstrāde joprojām izmanto sākotnējo ievadi. Nulles daudzums tāpēc var pieprasīt augšupējos krājumus un neatgriezt nevienu kandidātu. Citi mantotie zari ne vienmēr ievēro pieprasīto rezultātu skaitu. Nepaļaujieties uz vienu universālu maksimumu un nesūtiet negatīvas, daļskaitļu vai neciparu vērtības. Šim maršrutam nav dokumentēts neviens atbalstīts publisks meklēšanas filtrs vai cenas ID pamatteksta parametrs.

Atšķiriet krājumu trūkumu no uzmeklēšanas kļūmes

404 atbilde var nozīmēt nepieejamus krājumus, atspējotu pakalpojumu, neveiksmīgu piegādātāja uzmeklēšanu vai nederīgus kataloga ierakstus. Uztveriet noildzi vai pakalpojumu sniedzēja kļūmi kā nezināmu pieejamību, nevis apstiprinātus nulles krājumus. Atjauniniet atlasi un atkārtoti mēģiniet ar aizkavi, kad tas ir atbilstoši. Izvairieties no katras telefona centrāles atkārtotas aptaujas. Atsevišķais mobilo krājumu skaita galapunkts ir momentuzņēmuma norāde, un tam nav jāatbilst šī konta kandidātu saraksta garumam.

Pārbaudiet vēlreiz pirms iepirkšanās

Meklēšana nerezervē krājumus. Pārskatītais zars mēģina izslēgt jau iepirktos numurus, taču neveiksmīga iekšējās rezervācijas uzmeklēšana var atstāt šādu kandidātu rezultātā. Pieejamība, īpašumtiesības, apstiprinātās cenas un reģistrācija ir jāpārbauda iepirkuma darbplūsmā. Izmantojiet jaunu atlasi ar pasargātu iepirkuma pieprasījumu un saskaņojiet konta krājumus pēc jebkura neskaidra iepirkuma rezultāta pirms atkārtota mēģinājuma. Nekad nepērciet tikai tāpēc, ka kandidāts tika atgriezts.

Pieprasījums

Izmantojiet iespējotu API kontu caur HTTPS no atļautas avota IP adreses. Mobilo numuru krājumiem arī jābūt iespējotiem klienta kontam; vienīgi API autentifikācija tos neiespējo.

GET ar pašreizējo individuālo priedēkļu identifikatoru un pozitīvu vesela skaitļa daudzumu URL ceļā. Daudzums pēc noklusējuma ir 1, ja nav norādīts. Izmantojiet piemēru ar 1; šis maršruts nenodrošina konsekventu universāla rezultātu ierobežojuma pārbaudi vai piemērošanu.

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

Atbilde

Pārbaudiet status.code un status.msg JSON pamattekstā, kā arī HTTP statusu. Pēc izdošanās response ir numuru kandidātu saraksts, status.msg ir Results:, kam seko atgriezto numuru skaits, un status.results ir serializētā saraksta garums. Kandidātu cenas ir kontam specifiskas. Ilustratīvais saīsinātais piemērs izmanto vietturus reālu krājumu vai tarifu piedāvājuma vietā. Numuri satur valsts kodu bez plus zīmes; identifikatori ir necaurspīdīgas virknes.

Ilustratīva atbildes forma; nav reāli konta dati un nav pašreizējs piedāvājums.

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

Kļūdas

• 404: nederīgs priedēkļa ID, valsts vai apgabals: atjauniniet individuālā mobilā priedēkļa atlasi.
• 404: numuri nav atrasti: var nozīmēt nelietojamus krājumus, atspējotu pakalpojumu, neveiksmīgu pakalpojumu sniedzēja uzmeklēšanu, neatbalstītu atlasi vai konta ierobežojumus. Tas nav pierādījums par autoritatīvu nulles krājumu skaitu.

Pieejamība un blakusefekti

• Meklēšana nenomā un nerezervē numuru, un pārskatītais ceļš nenoraksta pirkuma summu. Tas sazinājas ar krājumu pakalpojumu sniedzēju un var aizņemt laiku.
• Veiksmīgas meklēšanas ieraksta ar kontu saistītos numuru un cenu kešatmiņas ierakstus un vaicājumu žurnālus. Meklēšanas atkārtošana nav rezervācija, cenas fiksēšana vai iepirkums.
• Atgrieztās cenas, nosacījumi, ierobežojumi un iespējas ir jāpārskata atlasītajam kontam un numuram. Iespējas marķējums neapstiprina aktivāciju, ziņapmaiņas apstiprinājumu vai pārbaudītu pakalpojuma funkcionalitāti.