Porositni numra telefoni nga një prefiks

Porositni nga një prefiks

Përdoreni këtë veprim kur katalogu i prefikseve ju udhëzon të porositni një sasi nga një prefiks në vend që të zgjidhni numra individualë të disponueshëm. Filloni me vendet, zonat ose shtetet federale dhe prefikset. Ruani identifikuesin e prefiksit dhe planin tarifor nga i njëjti rezultat i sapomarrë. Për një numër të caktuar të zgjedhur nga një listë numrash të disponueshëm, përdorni Blini një numër telefoni të zgjedhur.

Kjo kërkesë mund të blejë numra dhe të shkaktojë tarifa. Ajo nuk është ofertë çmimi, rezervim apo provë pa ekzekutim real. Shqyrtoni tarifat e konfigurimit dhe ato mujore, tarifat për minutat hyrëse, minutat e përfshira, kanalet, kërkesat e regjistrimit dhe kufijtë e blerjes së llogarisë përpara dërgimit. Një rezultat katalogu nuk rezervon inventar dhe as nuk i fikson çmimet. Kontrollet e financimit të llogarisë mund të kryhen përpara përmbushjes së porosisë; një gabim nuk provon në vetvete se nuk është kryer asnjë blerje apo financim i llogarisë.

Dërgoni kërkesën e blerjes

Përdorni një llogari API të aktivizuar përmes HTTPS nga një adresë IP burimore e lejuar. Vendosni variablat sipas përzgjedhjes suaj aktuale në katalog dhe konfigurimit tuaj të miratuar të dërgimit. Komanda e mëposhtme blen një numër.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'quantity=1' \
  --data-urlencode "price_id=$PRICE_ID" \
  --data-urlencode "channels=$CHANNELS" \
  --data-urlencode "reference=$ORDER_REFERENCE" \
  --data-urlencode "uri=$VOICE_URI" \
  "https://api.multitel.net/v3/order/$PREFIX_ID"

Më sipër paraqitet një kërkesë POST me formular. Koordinatori lexon gjithashtu një objekt JSON kur Content-Type është application/json. Fushat JSON kanë përparësi ndaj fushave përkatëse të formularit/kërkesës. Përdorni në mënyrë të njëtrajtshme një kodim të vetëm; mos dërgoni vlera që bien ndesh midis parametrave të URL-së dhe trupit të kërkesës.

Cilësimet e dërgimit dhe të rinovimit

Zgjidhni të njëjtat cilësime dërgimi që do të përdornit për numrin në portal. Këto janë vlera të konfigurimit të avancuar, jo udhëzime për të krijuar një central PBX të hostuar ose një trunk për origjinimin e thirrjeve. Ripërdorni një konfigurim llogarie që dihet se funksionon dhe verifikoni numrin e ruajtur pas blerjes. Vetëm pranimi i një blerjeje nuk verifikon që dërgimi i thirrjeve zanore ose i SMS-ve funksionon.

Këto fusha normalizohen dhe i kalohen procesit të përfundimit të blerjes, por ruajtja e tyre ndryshon sipas rrjedhave të inventarit. Rruga aktuale e porosisë nuk i ofron fushat e rrepta të kufirit maksimal të çmimit të ofertuar, të përshkruara në udhëzuesin e blerjes së një numri të zgjedhur, si masa mbrojtëse të barasvlershme. Përdorni lejet e blerjes dhe kufijtë e çmimeve të llogarisë dhe kontrolloni konfigurimin përfundimtar të numrit.

Lexoni rezultatin e plotë

Analizoni trupin JSON dhe kontrolloni status.code dhe status.msg edhe kur kërkesa HTTP përfundon me sukses. Kjo rrugë shkruan përgjigjen e vet JSON dhe as funksioni i përbashkët ndihmës i përgjigjeve nuk e lidh domosdoshmërisht kodin e aplikacionit me statusin HTTP. Kodet e aplikacionit mund të jenë numra JSON ose vargje karakteresh numerike. Mos kërkoni praninë e status.results; ajo nuk është e pranishme në rezultatin normal të porosisë.

{
  "status": {"code": "200", "msg": ""},
  "response": {
    "id": "o_fictional_example",
    "numbers": ["12025550123"],
    "price": {
      "per_minute": "0.01",
      "free_minutes": 0,
      "setup_price": "1.25",
      "monthly_price": "2.50",
      "channels": 2
    },
    "features": ["voice"],
    "needs_registration": 0,
    "restrictions": "",
    "registration_requirements": null
  }
}

Identifikuesi, numri dhe çmimet e mësipërme janë të sajuara. Trajtojeni ID-në e porosisë si një vlerë opake, pa interpretuar strukturën e saj. numbers rendit numrat që kjo përgjigje raporton si të blerë; krahasoni gjatësinë e listës me sasinë që kërkuat. Shumat e çmimeve janë vargje karakteresh dhe kjo përgjigje i rrumbullakos tarifat monetare në dy shifra pas presjes dhjetore, përfshirë per_minute; përdorni katalogun e sapomarrë për saktësinë origjinale të tarifave. Minutat e përfshira dhe kanalet mund të mbërrijnë si vlera numerike ose vargje karakteresh numerike.

Blloku i çmimit përshkruan planin e zgjedhur që është përdorur për të ndërtuar përgjigjen, jo një faturë të hollësishme për çdo numër ose totalin e porosisë. Kandidatë të ndryshëm të inventarit mund të kenë plane të ndryshme. Rakordoni numrat individualë të blerë dhe transaksionet e llogarisë në vend që të shumëzoni vlerat e këtij blloku dhe të supozoni se ai provon totalin përfundimtar.

Blerjet e pjesshme dhe rezultatet e pasigurta

Një kod aplikacioni 200 mund të shoqërohet me një paralajmërim dhe me më pak numra sesa janë kërkuar. Një dështim i mëvonshëm nuk i zhbën blerjet e numrave të blerë tashmë. Ruani ID-në e kthyer të porosisë, numrat dhe mesazhin. Rakordoni këta numra në inventarin tuaj dhe në transaksionet e llogarisë përpara se të vendosni nëse do të porositni sasinë e mbetur.

Skadimi i kohës së pritjes, ndërprerja e lidhjes së kërkesës, një përgjigje e formuar gabimisht ose një gabim pas dërgimit nuk janë provë se nuk ka ndodhur asgjë. Mos dërgoni automatikisht një blerje tjetër, edhe me të njëjtën referencë. Ruani kërkesën origjinale, referencën dhe çdo ID porosie të kthyer, kontrolloni inventarin dhe transaksionet e llogarisë dhe kontaktoni mbështetjen kur rezultati mbetet i pasigurt.

Një porosi e pakonfirmuar mund të kthejë kodin e aplikacionit 400 me një mesazh që thotë se ajo është ende në proces konfirmimi. Ruani ID-në e kthyer të porosisë dhe rakordoni atë blerje; ky nuk është udhëzim për ta dërguar përsëri. Rikuperimi i porosive të regjistruara e gjurmon brenda sistemit porosinë origjinale. Një kërkesë e re për këtë veprim krijon një përpjekje të veçantë blerjeje në vend që të rifillojë një porosi sipas referencës suaj, prandaj mund të blejë më shumë numra dhe t'ju faturojë për ta. Mos përdorni kërkesa të përsëritura blerjeje për të kontrolluar statusin ose për të kërkuar në inventar.

Regjistrimi dhe aktivizimi

Një numër i blerë ose i caktuar mund të ketë ende nevojë për regjistrim ose aktivizim. Nëse needs_registration është 1, kontrolloni restrictions dhe registration_requirements. Kjo e fundit mund të identifikojë v3/get_requirements me vlerat e country dhe number_type. Përfundoni procesin përkatës të identitetit/adresës dhe konfirmoni statusin e numrit përpara se të mbështeteni te thirrjet hyrëse ose mesazhet.

features përshkruan aftësitë e reklamuara; nuk verifikon drejtimin real të trafikut, miratimin e fushatës, dërgimin e SMS-ve ose marrjen e fakseve. Kontrolloni cilësimet e ruajtura të dërgimit dhe kryeni testin e përshtatshëm të shërbimit kur numri të jetë aktiv.

Njoftimet kthyese të porosisë

Njoftimet kthyese dërgojnë me POST të dhëna JSON që përmbajnë statusin dhe përgjigjen e porosisë, me referencën tuaj të shtuar kur ajo është dhënë. Ato dërgohen për blerjet e raportuara, përfshirë rezultatet e pjesshme. Një njoftim kthyes i dështuar nuk e zhbën blerjen. Dërgimi mund të riprovohet, prandaj trajtojini dublikatat sipas ID-së së porosisë dhe rakordoni numrat në vend që të nisni një blerje tjetër.

Kjo rrugë nuk shton një nënshkrim kriptografik për njoftimet kthyese. Trajtojeni një njoftim kthyes si njoftim për t'u rakorduar me inventarin tuaj të aksesuar me autentikim, jo si autorizim të pavarur për të faturuar, për të aktivizuar shërbime ose për të dhënë akses. Mos vendosni kredenciale API në URL-në e njoftimit kthyes. Dërgimi i një blerjeje tjetër me një URL tjetër njoftimi kthyes nuk e përditëson porosinë origjinale; ai krijon një përpjekje të veçantë blerjeje. Ruani ID-në e porosisë origjinale kur i kërkoni mbështetjes të hetojë njoftimin e saj kthyes.

Dështimet që duhen trajtuar