API - Pakalpojuma izveide

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):
 

Pakalpojuma pasūtījuma piemērs

Piemēram, izmantojam tarifa 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):

Š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="ok"' \
--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):

Š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):

Š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="ok"' \
--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 pakalpojumu pārvaldībai, piemēram: Sākt, Apturēt, Dzēst, Mainīt izmēru un citas.
 

Arī iesakām 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 Sākt & Apturēt
• API - Operācija Restartēt
• API - Operācija Atjaunot
• API - Operācija Dzēst
• API - Mijiedarbība ar attēlu
• API - Mijiedarbība ar rezerves kopiju grafiku
• API - Mijiedarbība ar Rescue
• API - Mijiedarbība ar rezerves kopiju
• API - Mijiedarbība ar snapshots
• API - Mijiedarbība ar Boot no ISO