Zgjidhni numrin dhe çmimin së bashku
Blini një numër të caktuar të zgjedhur nga një kërkim i ri i numrave të disponueshëm. Përdorni info.uuid të hyrjes së zgjedhur si ID të numrit dhe një nga vlerat price[].uuid të së njëjtës hyrje si ID të çmimit. Rruga pranon edhe numrin e plotë të ruajtur, por një ID shteti, zone ose prefiksi nuk e zëvendëson zgjedhjen e një numri.
Kërkimi ose leximi i çmimeve të ruajtura nuk rezervon një numër dhe as nuk e fikson çmimin e tij. Konfirmoni tarifën e konfigurimit, çmimin mujor, tarifën për minutë hyrëse, minutat dhe kanalet e përfshira për zgjedhjen tuaj, si edhe lejet e llogarisë për blerje dhe kërkesat e regjistrimit. Shuma bazë fillestare në funksionin ndihmës të shqyrtuar është tarifa e konfigurimit plus çmimi mujor; të gjitha tarifat dhe kushtet specifike të ofruesit duhet të konfirmohen për planin e zgjedhur.
Dërgoni me POST një kërkesë blerjeje me kontrolle mbrojtëse
Përdorni një llogari API të aktivizuar përmes HTTPS nga një adresë IP burimore e lejuar. Komanda e mëposhtme kryen një blerje, jo një kërkesë për ofertë ose një provë pa ekzekutim real. Vendosni çdo variabël nga e njëjta zgjedhje e re e numrit dhe çmimit. Fushat e kufijve maksimalë ruajnë prefiksin e vjetër restore_quote_; portali aktual i përdor gjithashtu për blerje të numrave të caktuar me kontrolle mbrojtëse.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--data-urlencode "restore_quote_price_id=$PRICE_ID" \
--data-urlencode "restore_quote_setup=$SETUP_PRICE" \
--data-urlencode "restore_quote_monthly=$MONTHLY_PRICE" \
--data-urlencode "restore_quote_per_minute=$PER_MINUTE_PRICE" \
--data-urlencode "restore_quote_channels=$CHANNELS" \
"https://api.multitel.net/v3/rentnumber/$NUMBER_ID/$PRICE_ID"Përdorni POST me të dhëna formulari siç tregohet. Funksioni ndihmës mbështet gjithashtu analizimin e JSON dhe të mbështjellësit të opsioneve, por ky shqyrtim nuk ka vërtetuar barasvlerë të plotë për të gjitha rrugët e ofertave dhe të ofruesve. Mos përdorni GET për blerje, edhe pse ky koordinator i vjetër nuk ka një kontroll të shprehur për metodën.
| Fusha | Kuptimi |
|---|---|
| NUMBER_ID | UUID-ja e numrit të zgjedhur nga kërkimi, ose numri i plotë i ruajtur. Një numër për çdo kërkesë. |
| PRICE_ID | UUID-ja e çmimit të lidhur me atë numër të zgjedhur dhe me llogarinë tuaj. Jepeni gjithmonë shprehimisht. |
| restore_quote_price_id | Duhet të përputhet me ID-në e çmimit të përcaktuar nga sistemi. Dhënia e kësaj fushe aktivizon kontrollet e ofertës; ajo nuk është çelës idempotence. |
| restore_quote_setup | Tarifa maksimale e pranuar e konfigurimit, si vlerë numerike e fundme dhe jonegative. |
| restore_quote_monthly | Çmimi mujor maksimal i pranuar, si vlerë numerike e fundme dhe jonegative. |
| restore_quote_per_minute | Tarifa maksimale e pranuar për minutë hyrëse, si vlerë numerike e fundme dhe jonegative. |
| restore_quote_channels | Numri i saktë i kanaleve, i shprehur si numër i plotë, për opsionin e zgjedhur të çmimit; nuk është kërkesë për një plan tjetër kanalesh. |
Jepni të gjitha fushat numerike të ofertës sa herë që jepni ID-në e çmimit të ofertës. Një ID e ndryshuar, një çmim mbi kufirin maksimal, një kufi maksimal që mungon ose është i pavlefshëm, një numër i ndryshuar kanalesh ose një kyçje e zënë e ofertës kthen kodin API 409 përpara se kërkesa t'i dërgohet ofruesit të zgjedhur të marrjes me qira. Krahasimet lejojnë një tolerancë të vogël për numrat me presje lëvizëse; përdorni vlerat reale të shfaqura të planit dhe jo një çmim të rrumbullakosur me dorë.
Kontrollet mbrojtëse nuk e kthejnë të gjithë rrjedhën e punës në një provë pa ekzekutim real ose në një transaksion. Kërkimet e regjistrimit, krijimi i identitetit në sistem ose veprime të tjera të funksionit ndihmës mund të ndodhin përpara këtyre kontrolleve. Ato gjithashtu nuk e fiksojnë inventarin e jashtëm dhe nuk zëvendësojnë kufizimet e blerjes në nivel llogarie.
Regjistrimi dhe aktivizimi
Kur kërkohet, shtoni fushën e formularit RegistrationID që përmban UUID-në e profilit të regjistrimit në pronësi të klientit. Ajo nuk është ID-ja e një dokumenti dëshmues të ngarkuar, e një adrese të furnizuesit ose e një entiteti të veçantë identiteti. Funksioni ndihmës e identifikon profilin në kuadrin e llogarisë së autentikuar dhe refuzon profilet që mungojnë ose nuk janë të disponueshme.
Një pjesë e inventarit të mbështetur lejon blerjen përpara se regjistrimi të përfundojë; pjesë të tjera të inventarit kërkojnë një profil përpara blerjes. Mund të nevojitet ende vërtetim ose konfigurim në sistem sipas operatorit. Mos e interpretoni një blerje të suksesshme ose mungesën e një kontrolli paraprak si përjashtim nga regjistrimi ose si aktivizim të menjëhershëm.
Kur është e pranishme, fusha registration_requirements e përgjigjes identifikon kërkimin e strukturuar të kërkesave sipas shtetit dhe llojit të numrit. Përdorni katalogun e regjistrimit dhe rrjedhën e punës për dokumentet dëshmuese për të përmbushur kërkesat përkatëse. Teksti dhe të dhënat përshkruese të kthyera nuk e miratojnë vetvetiu një profil.
Shmangni zëvendësimin e planit pa njoftim
Koordinatori i vjetër mund të nxjerrë një çmim të paspecifikuar nga të dhënat e numrit të ruajtura në memorien e përkohshme. Ai mund të përdorë gjithashtu, si alternativë rezervë, çmimin më të fundit të llogarisë për një prefiks të ruajtur në memorien e përkohshme kur një ID çmimi e dhënë shprehimisht nuk ekziston më, dhe të përditësojë zgjedhjen e çmimit të lejuar të ruajtur në këtë memorie. Mos u mbështetni te këto alternativa rezervë për të zgjedhur planin që ka miratuar klienti.
Jepni shprehimisht çmimin e zgjedhur dhe fushat përkatëse të kontrolleve mbrojtëse të ofertës. Kontrolli mbrojtës i ID-së së ofertës refuzon kalimin te një ID tjetër përpara dërgimit të kërkesës për marrje me qira. Pas një konflikti për shkak të një çmimi të vjetruar, rifreskoni kërkimin dhe merrni një zgjedhje të miratuar rishtazi, në vend që të hiqni kontrollet mbrojtëse për të detyruar blerjen.
Nuk ka një periudhë të garantuar rezervimi ose një afat vlefshmërie të memories së përkohshme që zbatohet në mënyrë universale për çdo rrugë. Disponueshmëria e numrit, kufijtë e çmimeve të llogarisë dhe politikat e blerjes kontrollohen sërish gjatë rrjedhës së punës, por sjellja e plotë specifike e secilit ofrues mbetet në shqyrtim.
Cilësime të avancuara: vlerat e parazgjedhura të drejtimit në llogari
Një blerje mund të trashëgojë destinacionet ekzistuese të thirrjeve zanore, destinacionet rezervë në rast dështimi, destinacionin e SMS-ve dhe preferencën për trungun e origjinimit të llogarisë. Shqyrtoni këto vlera të parazgjedhura përpara porositjes; mosdhënia e opsioneve të drejtimit nuk garanton një numër të pakonfiguruar. Funksioni ndihmës i shqyrtuar aktivizon si parazgjedhje rinovimin automatik.
| Opsioni | Mënyra e përcaktimit të vlerës |
|---|---|
| uri, uri2, uri3 | Vlerat e paspecifikuara trashëgojnë vlerat përkatëse të parazgjedhura të llogarisë. Vlerat e dhëna shprehimisht si bosh e zbrazin vlerën në funksionin ndihmës në vend që ta trashëgojnë. Përdorni destinacione të vlefshme dhe të përshtatshme për mënyrën e zgjedhur të drejtimit. |
| smsuri | Një vlerë e paspecifikuar trashëgon destinacionin e SMS-ve të llogarisë; një vlerë e dhënë shprehimisht si bosh e zbraz atë në funksionin ndihmës. |
| origintrunk | Një ID trungu e dhënë shprehimisht dhe e njohur nga sistemi ka përparësi. Një vlerë që nuk mund të identifikohet mund të zëvendësohet nga preferenca e llogarisë ose nga vlera e vjetër e parazgjedhur, në vend që të shkaktojë gabim. |
| forward_destination, forwarding_destination, type | Emërtime alternative jo të zbrazëta për mënyrën e drejtimit, me përparësi sipas këtij rendi. Përdorni vlera të mbështetura nga konfigurimi i drejtimit të llogarisë, jo një mënyrë numerike të hamendësuar. |
| RegistrationID | Kërkim i profilit të regjistrimit, i kufizuar te klienti përkatës; është i veçantë nga destinacionet e drejtimit. |
| autorenew | Vlera e parazgjedhur është 1. Funksioni ndihmës kontrollon nëse vlera është jo e zbrazët, prandaj 0 nuk e çaktivizon në mënyrë të besueshme rinovimin përmes kësaj fushe blerjeje. Përdorni menaxhimin e mbështetur të rinovimit të llogarisë dhe verifikoni cilësimin e ruajtur. |
Këto janë rregullat e funksionimit të funksionit ndihmës të përbashkët, jo garanci se çdo furnizues ruan në mënyrë identike çdo cilësim opsional. Ekzistojnë edhe fusha të tjera të vjetra për zërin, postën zanore, faksin dhe SMS-të, por ato ende kërkojnë shqyrtim të plotë sipas ofruesit. Verifikoni konfigurimin e ruajtur të numrit të blerë përmes rrjedhës së punës së llogarisë përpara se të mbështeteni te thirrjet ose mesazhet.
Përgjigjja
Shembull i trilluar për një blerje pa ndërlikime; vlerat dhe veçoritë ndryshojnë sipas planit të zgjedhur.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"price": {
"per_minute": "0.0100",
"free_minutes": "100",
"setup_price": "2.00",
"monthly_price": "4.00",
"channels": "2",
"overflow": "0"
},
"features": [
"voice"
],
"needs_registration": 0,
"registration_requirements": null
}
}Koordinatori përdor fushat e veta status.code/status.msg dhe mbështjellësin response, pa garanci për fushën status.results. Një gabim zakonisht ka një listë të zbrazët përgjigjeje. Në rast suksesi, shqyrtoni numrin dhe çmimin e kthyer, pastaj verifikoni përputhjen e inventarit të llogarisë dhe gjendjes së regjistrimit. Pranimi nga ofruesi nuk është një test real i zërit, SMS-ve ose faksit.
Gabimet dhe rezultatet e pasigurta
| Kodi API | Kuptimi |
|---|---|
| 403 | Kufizimet e çmimit ose blerjes të llogarisë, një zgjedhje çmimi e padisponueshme ose një profil regjistrimi i paaksesueshëm mund të bllokojnë përpunimin. |
| 404 | Zgjedhja e numrit, çmimit ose prefiksit mungon ose nuk është e disponueshme. |
| 409 | Numri është tashmë aktiv, një kontroll mbrojtës i ofertës nuk përputhet më ose një veprim tjetër i mbrojtur mban kyçjen. |
| 422 | Informacioni i regjistrimit kërkohet, është i paplotë ose nuk mund të vendoset në sistem në rrugët e shqyrtuara të regjistrimit. |
| 500 dhe kode të tjera të ofruesit ose llogarisë | Dështim i ofruesit, i përpunimit lokal ose për shkak të politikave. Këto nuk përbëjnë provë të përgjithshme se nuk ka ndodhur asnjë blerje ose faturim. |
Lexoni përmbajtjen reale të përgjigjes API si edhe statusin HTTP. Një ofrues i jashtëm mund ta pranojë një marrje me qira përpara se njoftimi lokal, regjistrimi ose përpunime të tjera të dështojnë. Disa caktime nga inventari lokal përdorin transaksione të bazës së të dhënave, por nuk ka një mekanizëm universal për zhbërjen e porosive te ofruesit e jashtëm. Ky koordinator nuk ka çelës idempotence të klientit.
Verifikoni përputhjen e të dhënave përpara se të riprovoni
- Ruani numrin, çmimin dhe kufijtë maksimalë të ofertës të miratuar në regjistrin e porosisë të aplikacionit tuaj përpara se ta dërgoni kërkesën vetëm një herë.
- Lexoni inventarin e numrave të blerë dhe hollësitë e numrit për të njëjtën llogari pas kërkesës, përfshirë edhe pas skadimit të kohës së pritjes ose një gabimi.
- Nëse numri ekziston, verifikoni çmimin, rinovimin, drejtimin dhe gjendjen e regjistrimit të tij në vend që të dërgoni një kërkesë tjetër blerjeje.
- Nëse rezultati është ende i pasigurt, kërkojini shërbimit të mbështetjes të verifikojë përputhjen e porosisë te ofruesi me faturimin e llogarisë përpara se të riprovoni. Vetëm një mesazh gabimi ose një tregues suksesi në regjistrat e sistemit të vjetër nuk është provë e mjaftueshme.
- Pasi të konfirmohen pronësia dhe aktivizimi, kryeni kontrollet e zakonshme të drejtimit dhe testet e shërbimit të llogarisë.