Gjeni numrat mobilë të disponueshëm

Konfirmoni që inventari mobil është i aktivizuar

Përdorni këtë kërkim vetëm pasi të jetë aktivizuar inventari i numrave mobilë për llogarinë tuaj të klientit. Merrni një prefiks individual aktual mobil përmes rrjedhës së punës së zbulimit të llogarisë. Rruga e mbështetur kërkon inventar wireless për atë prefiks. Nuk varet nga një regjistrim përputhës i metadatave të rutimit wireline. Lidhuni me mbështetjen nëse nuk jeni të sigurt nëse llogaria ose prefiksi juaj është i aktivizuar.

Rruga aktuale e trashëguar nuk refuzon në mënyrë të besueshme çdo kërkesë të papërshtatshme. Një llogari pa inventarin mobil të aktivizuar mund të marrë inventar të zakonshëm ndërsa përgjigja ende thotë info.is_mobile: 1. Një prefiks pa pagesë mund të arrijë gjithashtu në degën e inventarit pa pagesë me atë etiketë. Mos përdorni vetëm këtë etiketë për të identifikuar shërbimin mobil dhe mos dërgoni prefikse të zakonshme ose pa pagesë në këtë pikëfund. Përdorni katalogun mobil të konfirmuar të llogarisë dhe rrjedhën e punës së aktivizuar.

Mbani çdo numër me zgjedhjen e vet të çmimit

Për çdo kandidat, mbani number, info.uuid dhe listën e të njëjtit zë price bashkë. Përgjigja përmban gjithashtu metadata prefiksi/zone/vendi, kushte kontraktuale dhe kufizime regjistrimi. Kandidatët renditen sipas çmimit mujor të opsionit të parë të çmimit të tyre, në rritje; nuk ka rend të garantuar të qëndrueshëm për çmime të barabarta. Mos zëvendësoni ID-në e numrit të kthyer me një ID zone ose prefiksi, dhe mos e çiftoni me ID-në e çmimit të një kandidati tjetër.

Përgjigja e plotë mund të përfshijë fusha shtesë metadatash dhe çmimesh. Fushat e kthyera features, vlerat e kanaleve dhe restrictions përshkruajnë kandidatin; ato nuk janë garanci që thirrjet, SMS, MMS ose faksi janë tashmë të përdorshme. Lejet e llogarisë, regjistrimi dhe plani i shërbimit i zgjedhur zbatohen ende. Mos i trajtoni vendmbajtësit e shembullit si ID ose çmime të vlefshme.

Përdorni një sasi të vogël pozitive

Nisni me një sasi prej 1. Kërkesa normale e ofruesit normalizon një sasi jopozitive në 1 dhe kufizon vlerën upstream në 300, por trajtimi i mëvonshëm i rezultateve përdor ende inputin origjinal. Një sasi zero mund pra të kërkojë inventar upstream dhe të mos kthejë kandidatë. Degët e tjera të trashëguara nuk zbatojnë në mënyrë të qëndrueshme numrin e kërkuar të rezultateve. Mos u mbështetni në një maksimum të vetëm universal dhe mos dërgoni vlera negative, thyesore ose jonumerike. Asnjë filtër publik kërkimi i mbështetur ose parametër trupi me ID çmimi nuk është dokumentuar për këtë rrugë.

Dalloni mungesën e stokut nga dështimi i kërkimit

Një përgjigje 404 mund të përfaqësojë inventar të padisponueshëm, shërbim të çaktivizuar, kërkim të dështuar te furnizuesi ose regjistra katalogu të pavlefshëm. Trajtoni një timeout ose dështim të ofruesit si disponibilitet të panjohur dhe jo si stok zero të konfirmuar. Rifreskoni zgjedhjen dhe riprovoni me backoff kur është e përshtatshme. Shmangni sondazhin e përsëritur të çdo centrale telefonike. Pika fundore e veçantë e numërimit të inventarit mobil jep një tregues të gjendjes në një çast dhe nuk ka detyrim të përputhet me gjatësinë e listës së kandidatëve të kësaj llogarie.

Riverifikoni përpara blerjes

Kërkimi nuk rezervon stok. Dega e shqyrtuar përpiqet të përjashtojë numrat e blerë tashmë, por një kërkim lokal i dështuar rezervimi mund të lërë një kandidat të tillë në rezultat. Disponibiliteti, pronësia, çmimet e aprovuara dhe regjistrimi duhet të kontrollohen nga rrjedha e punës e blerjes. Përdorni një zgjedhje të re me kërkesën e mbrojtur të blerjes dhe pajtoni inventarin e llogarisë pas çdo rezultati të pasigurt blerjeje përpara riprovimit. Mos blini kurrë thjesht sepse është kthyer një kandidat.

Kërkesa

Përdorni një llogari API të aktivizuar përmes HTTPS-së nga një adresë IP burimi e lejuar. Inventari mobil duhet gjithashtu të jetë i aktivizuar për llogarinë e klientit; autentikimi i vetëm i API-së nuk e aktivizon atë.

GET me identifikuesin aktual të prefiksit individual dhe një sasi pozitive me numër të plotë në rrugën URL. Sasia merr vlerën e parazgjedhur 1 nëse nuk jepet. Përdorni shembullin me 1; kjo rrugë nuk validon dhe nuk zbaton në mënyrë të qëndrueshme një kufi universal rezultatesh.

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

Përgjigja

Inspektoni status.code dhe status.msg në trupin JSON si dhe statusin HTTP. Me sukses, response është një listë kandidatësh numrash, status.msg është Results: e ndjekur nga numri i kthyer, dhe status.results është gjatësia e serializuar e listës. Çmimet e kandidatëve janë specifike për llogarinë. Shembulli ilustrativ i shkurtuar përdor vendmbajtës në vend të inventarit real ose të një oferte tarifore. Numrat përmbajnë kodin e vendit pa shenjën plus; identifikuesit janë vargje opake.

Formë ilustrative përgjigjeje; jo të dhëna live të llogarisë ose ofertë aktuale çmimi.

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

Gabimet

• 404: ID prefiksi, vend ose zone e pavlefshme: rifreskoni zgjedhjen e prefiksit individual mobil.
• 404: Nuk u gjetën numra: mund të nënkuptojë stok të papërdorshëm, shërbim të çaktivizuar, kërkim të dështuar te ofruesi, zgjedhje të pambështetur ose kufizime llogarie. Nuk është provë e një numërimi autoritar zero të inventarit.

Disponibiliteti dhe efektet anësore

• Kërkimi nuk merr me qera dhe nuk rezervon një numër dhe rruga e shqyrtuar nuk debiton një shumë blerjeje. Lidhet me ofruesin e inventarit dhe mund të marrë kohë.
• Kërkimet e suksesshme shkruajnë zëra cache-je numrash dhe çmimesh të lidhura me llogarinë dhe regjistra pyetjesh. Përsëritja e një kërkimi nuk është rezervim, bllokim çmimi ose blerje.
• Çmimet, kushtet, kufizimet dhe aftësitë e kthuara duhet të shqyrtohen për llogarinë dhe numrin e zgjedhur. Një etiketë funksioni nuk vendos aktivizim, aprovim mesazhesh ose funksionalitet të testuar shërbimi.