PIESLĒGTIES
    opened image

    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 Pakalpojuma pasūtīšanas funkcija
    auth 21fc199...c43f71 Sesijas tokens. Tas ir viens no autorizācijas variantiem. Sīkāk par citiem variantiem ir aprakstīts šeit
    out json Kādā formātā gaidīt atbildi no API
    sok ok Operācijas apstiprinājums
    order_period -50 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 Atbilst piekrišanai par lietošanas licenci
    pricelist 6740 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 Pakalpojumu skaits, ko var pasūtīt vienā pieprasījumā
    force_use_new_cart on Pakalpojuma pievienošana jaunam billmanager grozam
    instances_ssh_keys 490 SSH atslēgas ID, kuru nepieciešams pievienot serverim pēc OS uzstādīšanas. Nav jānodod, ja parametrs use_ssh_key=off
    password Mypassword1 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 Pašizveidots servera nosaukums
    instances_os 18d0ee2e-4d57-4f40-9b56-03c1773b5831 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 Vai izmantot SSH atslēgu vai nē. Var pieņemt vērtības off vai on.
    addon_xxx

    260

    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, var piemēra aprakstā šeit
    datacenter

    13

    Datu centra numurs. Uzzināt, kādas opcijas ir pieejamas, var piemēra aprakstā šeit
    backups_schedule on Rezerves kopiju grafika izveide, veicot rezerves kopijas izveidi
    backups_schedule_name MyBackup Jā, ja tiek izmantota vērtība backups_schedule Nosaukums rezerves kopijas izveides grafikam
    backups_schedule_rotation_days 1,2,3,4,5,6,0 Jā, ja tiek izmantota vērtība backups_schedule Kādās dienās veikt rezerves kopijas. Nedēļas sākums ir svētdienā, un tam ir ID - 0. Attiecīgi pirmdienai ir vērtība 1. Pārējām nedēļas dienām - attiecīgās vērtības.
    backups_schedule_rotation_time 04:20 Jā, ja tiek izmantota vērtība backups_schedule Kādā laikā izveidot rezerves kopiju

     

     

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

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

    Parametrs Piemēra vērtība Obligāts parametrs Vērtības apraksts
    func cart Funkcijas nosaukums darbam ar grozu
    auth 21fc199...c43f71 Sesijas tokens. Tas ir viens no autorizācijas variantiem. Sīkāk par citiem variantiem ir aprakstīts šeit
    out json Kādā formātā gaidīt atbildi no API
    sok ok Operācijas apstiprinājums
    promocode PROMO_2024 Akcijas kods, kuru plānots izmantot. 
    clicked_button apply_promocode 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 Funkcija darbam ar grozu
    auth 21fc199...c43f71 Sesijas tokens. Tas ir viens no autorizācijas variantiem. Sīkāk par citiem variantiem ir aprakstīts šeit
    out json Kādā formātā gaidīt atbildi no API
    sok ok Operācijas apstiprinājums
    elid 1818 Pasūtījuma ID. Šī vērtība tika iegūta, pievienojot pakalpojumu grozam
    paymethod_id 0 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="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: