Pasūtījuma veikšanas procesā platformā Zomro ir jāievēro vairāki svarīgi posmi: pakalpojuma pievienošana grozam, akcijas koda aktivizēšana (ja tāds ir), un tieši pakalpojuma iegāde. Šie soļi ļauj efektīvi izmantot akcijas kodu funkcionalitāti pasūtījuma laikā. Lai veiktu pasūtījumu, ir jānodod noteikti pakalpojuma parametri, kuru detaļas ir sniegtas zemāk.
Pasūtījuma izveides process sastāv no šādiem posmiem:
- Pakalpojuma pievienošana grozam
- Akcijas koda aktivizēšana
- Pakalpojuma iegāde no groza
Tieši šādu pirkšanas posmu izmantošana ļauj izmantot akcijas kodu pasūtījuma laikā.
Lai izveidotu pasūtījumu, ir jānodod pakalpojuma parametri, kas mūs interesē. Kā iegūt pieejamos parametrus, ir aprakstīts šeit .
Pieprasījuma struktūra pakalpojuma Cloud VPS Zomro pasūtīšanai:
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
Parametrs | Piemēra vērtība | Obligāts parametrs | Vērtības apraksts |
func | v2.instances.order.param | Jā | Pakalpojuma pasūtīšanas funkcija |
auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas variantiem. Sīkāk par citiem variantiem ir aprakstīts šeit |
out | json | Nē | Kādā formātā gaidīt atbildi no API |
sok | ok | Jā | Operācijas apstiprinājums |
order_period | -50 | Jā | Cloud VPS pakalpojumiem tiek izmantota ikdienas iekasēšana. Lai veiktu pakalpojuma iegādi, izmantojiet vērtību: -50, 1, 3, 6, 12. -50 - ikdienas iekasēšana, 1 - pakalpojuma pasūtīšana uz 1 mēnesi, 3 - pasūtījums uz 3 mēnešiem un tā tālāk. |
licence_agreement | on | Jā | Atbilstība ar licenci par izmantošanu |
pricelist | 6740 | Jā | Tarifa ID, kuru nepieciešams pasūtīt. Tarifa ID var iegūt no funkcijas v2.instances.order.pricelist. Sīkāk par to, kā izmantot, ir aprakstīts šeit |
order_count | 1 | Jā | Pakalpojumu skaits, ko var pasūtīt vienā pieprasījumā |
force_use_new_cart | on | Jā | Pakalpojuma pievienošana jaunam billmanager grozam |
instances_ssh_keys | 490 | Nē | SSH atslēgas ID, kuru nepieciešams pievienot serverim pēc operētājsistēmas uzstādīšanas. Nav jānodod, ja parametrs use_ssh_key=off |
password | Mypassword1 | Nē | Piekļuves parole serverim. Linux gadījumā - parole lietotājam root. Windows gadījumā - Administrator lietotāja parole. Nav jānodod, ja parametrs use_ssh_key=on. Arī parolei jāietver vismaz 1 lielais angļu burts, 1 cipars, minimālais simbolu skaits ir 8. |
servername | MyServer | Nē | Pašizveidots servera nosaukums |
instances_os | 18d0ee2e-4d57-4f40-9b56-03c1773b5831 | Jā | Operētājsistēmas UID, kuru nepieciešams uzstādīt. Operētājsistēmas UID var iegūt no funkcijas v2.instances.order.pricelist. Sīkāk par to, kā izmantot, ir aprakstīts šeit |
use_ssh_key | off | Nē | Vai izmantot SSH atslēgu vai nē. Var pieņemt vērtības off vai on. |
addon_xxx |
260 |
Nē | Papildu pakalpojuma parametri. Var būt RAM, CPU skaits, diska izmērs, datu apjoms, IPv4 vai IPv6 tips. Pieejamie parametri ir atkarīgi no tarifa. Uzzināt, kādas opcijas ir pieejamas, varat piemērā, kas aprakstīts šeit |
datacenter |
13 |
Jā | Datu centra numurs. Uzzināt, kādas opcijas ir pieejamas, varat piemērā, kas aprakstīts šeit |
Pakalpojuma pasūtījuma piemērs
Piemēram, izmantojam tarifu Cloud Essential ar operētājsistēmu Linux Ubuntu 20.04, serveris tikai ar IPv6 un ar root lietotāja paroli.
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
Parametrs | Vērtība |
func | v2.instances.order.param |
auth | 21fc199...c43f71 |
out | json |
sok | ok |
order_period | -50 |
licence_agreement | on |
pricelist |
6740 |
order_count | 1 |
password | MyPassword1 |
servername | MyServer-1 |
instances_os |
479c96f1-ccc6-47a2-952c-c9e3bbdc8d07 |
use_ssh_key | off |
addon_6746 |
260 |
force_use_new_cart | on |
datacenter | 13 |
Šeit ir pieprasījuma piemērs, ko var izpildīt no konsoles:
curl --location 'https://api.zomro.com/' \
--form 'func="v2.instances.order.param"' \
--form 'auth="211a9ac6309a9f0c340bdebf"' \
--form 'out="json"' \
--form 'sok="on"' \
--form 'order_period="-50"' \
--form 'licence_agreement="on"' \
--form 'use_ssh_key="off"' \
--form 'pricelist="6740"' \
--form 'servername="MyServer-1"' \
--form 'password="Mypassword1"' \
--form 'instances_os="479c96f1-ccc6-47a2-952c-c9e3bbdc8d07"' \
--form 'order_count="1"' \
--form 'addon_6746="260"' \
--form 'datacenter="13"' \
--form 'force_use_new_cart="on"'
Pēc pieprasījuma izpildes mums ir nepieciešami dati, kas atrodas nākamajā ieliktajā struktūrā:
doc
Šeit ir vērtības, kas iegūtas pieprasījuma izpildes rezultātā:
...,
"lineitem.id": {
"$": "1818"
},
...
Šī vērtība "1818", kas ir pasūtījuma numurs grozā, ir nepieciešama turpmākai pakalpojuma aktivizēšanai. Atcerēsimies to turpmākai lietošanai.
Pēc šī pieprasījuma izpildes grozā var redzēt arī esošo preci.
Nākamais posms būs akcijas koda aktivizēšana, ja tāds ir. Šis posms nav obligāts, bet, ja klientam ir akcijas kods, būtu lieliski to izmantot.
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
Parametrs | Piemēra vērtība | Obligāts parametrs | Vērtības apraksts |
func | cart | Jā | Funkcijas nosaukums darbam ar grozu |
auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas variantiem. Sīkāk par citiem variantiem ir aprakstīts šeit |
out | json | Nē | Kādā formātā gaidīt atbildi no API |
sok | ok | Jā | Operācijas apstiprinājums |
promocode | PROMO_2024 | Jā | Akcijas kods, kuru plānots izmantot. |
clicked_button | apply_promocode | Jā | Akcijas koda aktivizēšanas apstiprinājums |
Šeit ir pieprasījuma piemērs, ko var izpildīt no konsoles:
curl --location 'https://api.zomro.com/' \
--form 'out="json"' \
--form 'auth="46ffb314c8d46ec1f2f1df16"' \
--form 'func="cart"' \
--form 'promocode="PROMO_2024"' \
--form 'sok="ok"' \
--form 'clicked_button="apply_promocode"'
Pēc šī pieprasījuma izpildes grozā var redzēt akcijas koda aktivizēšanas rezultātu:
Attēlā redzams, ka akcijas kods PROMO_2024 ir veiksmīgi aktivizēts.
PS: Patiesībā, akcijas kods PROMO_2024, jūsu gadījumā, nav derīgs, tas tika izveidots tikai šīs instrukcijas rakstīšanai.
Nākamais posms būs pakalpojuma aktivizēšana.
Ja akcijas kods nesniedz 100% atlaidi, ir jāveic papildu maksājums par pakalpojumu no personīgā konta.
Apskatīsim situāciju, ja akcijas kods nepārklāj 100% pakalpojuma izmaksas. API pieprasījums izskatīsies šādi:
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
Parametrs | Piemēra vērtība | Obligāts parametrs | Vērtības apraksts |
func | cartorder.create.confirm | Jā | Funkcija darbam ar grozu |
auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas variantiem. Sīkāk par citiem variantiem ir aprakstīts šeit |
out | json | Nē | Kādā formātā gaidīt atbildi no API |
sok | ok | Jā | Operācijas apstiprinājums |
elid | 1818 | Jā | Pasūtījuma ID. Šī vērtība iegūta, pievienojot pakalpojumu grozam |
paymethod_id | 0 | Jā | Maksājuma metodes ID. Vērtība 0 ir standarta un atbilst pasūtījuma apmaksai no personīgā konta līdzekļiem |
Šeit ir pieprasījuma piemērs, ko var izpildīt no konsoles:
curl --location 'https://api.zomro.com/' \
--form 'out="json"' \
--form 'auth="cd63c7832f0ae5947c49ac06"' \
--form 'func="cartorder.create.confirm"' \
--form 'sok="on"' \
--form 'elid="1818"' \
--form 'paymethod_id="0"'
Pēc šī pieprasījuma izpildes grozā šim pakalpojumam nevajadzētu būt, visā CloudVPS pakalpojumu sarakstā redzam mūsu pakalpojumu statusā "Aktivizācija notiek":
Aktivizācijas procesa laikā papildu darbības ar pakalpojumu nav. Pēc pakalpojuma aktivizēšanas mums tiks atvērts pieejamo darbību saraksts, lai pārvaldītu pakalpojumus, piemēram: Sākt, Apturēt, Dzēst, Pārveidot un citas.
Arī piedāvājam izpētīt rakstus, kas var būt noderīgi mijiedarbībai ar Cloud VPS produktiem, izmantojot API:
- API - Informācijas iegūšana par pieejamajiem tarifiem un to parametriem
- API - Operācija Start & Stop
- API - Operācija Reboot
- API - Operācija Rebuild
- API - Operācija Delete
- API - Mijiedarbība ar Backup Schedule
- API - Mijiedarbība ar Rescue
- API - Mijiedarbība ar Backup
- API - Mijiedarbība ar Snapshots
- API - Mijiedarbība ar Boot From ISO
- API - Mijiedarbība ar Image