PIESLĒGTIES
    opened image

    Pasūtot pakalpojumu platformā Zomro, ir jāievēro vairāki svarīgi soļi: pakalpojuma pievienošana grozam, promo koda aktivizēšana (ja tāds ir), un tieša pakalpojuma iegāde. Šie soļi ļauj efektīvi izmantot promo kodus pasūtījuma laikā. Lai veiktu pasūtījumu, ir jānodod noteikti pakalpojuma parametri, kuru detaļas ir norādītas zemāk.

    Pasūtījuma izveides process sastāv no šādiem soļiem:

    • Pakalpojuma pievienošana grozam
    • Promo koda aktivizēšana
    • Pakalpojuma iegāde no groza

    Izmantojot tieši šādus pirkuma soļus, var izmantot promo kodu pasūtījuma laikā.

    Lai izveidotu pasūtījumu, ir jānodod pakalpojuma parametri, kas mūs interesē. Kā iegūt pieejamos parametrus, 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 Vērtības piemērs 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 veidiem. Vairāk par citiem veidiem aprakstīts šeit
    out json Kādā formātā sagaidīt atbildi no API
    sok ok Operācijas apstiprinājums
    order_period -50 Cloudvps pakalpojumiem tiek izmantota stundas maksa. Lai veiktu pirkumu stundas maksā, tiek izmantota vērtība -50
    licence_agreement on Atbilst licences lietošanas piekrišanai
    pricelist 6740 Tarifa ID, kuru nepieciešams pasūtīt. Tarifa ID var iegūt no funkcijas v2.instances.order.pricelist. Vairāk par to, kā izmantot, aprakstīts šeit
    order_count 1 Pakalpojumu skaits, ko var pasūtīt vienā pieprasījumā
    force_use_new_cart on Pakalpojuma pievienošana jaunajam billmanager grozam
    instances_ssh_keys 490 SSH atslēgas ID, kuru nepieciešams pievienot serverim pēc OS instalēšanas. Nav nepieciešams nodot, ja parametrs use_ssh_key=off
    password Mypassword1 Piekļuves parole serverim. Linux gadījumā - parole root lietotājam. Windows gadījumā - Administrator lietotāja parole. Nav nepieciešams nodot, ja parametrs use_ssh_key=on.
    Tāpat parolei jābūt vismaz 1 lielajam angļu burtam, 1 ciparam, minimālais simbolu skaits 8.  
    servername MyServer Servera nosaukums
    instances_os 18d0ee2e-4d57-4f40-9b56-03c1773b5831 Operētājsistēmas UID, kuru nepieciešams instalēt. Operētājsistēmas UID var iegūt no funkcijas v2.instances.order.pricelist. Vairāk par to, kā izmantot, 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, trafika apjoms, IPv4 vai IPv6 tips. Pieejamie parametri ir atkarīgi no tarifa. Uzzināt, kādas opcijas ir pieejamas, var piemēra aprakstā šeit

     

    Pakalpojuma pasūtījuma piemērs

    Piemēram, izmantosim tarifu Cloud Essential ar OS Linux Ubuntu 20.04, serveri tikai ar IPv6 un 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

     

    Lūk, pieprasījuma piemērs, kuru 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 'force_use_new_cart="on"'

     

    Pēc pieprasījuma izpildes, mums ir nepieciešami dati, kas atrodas šādā ligzdojumā:

    doc

     

    Lūk, 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 izmantošanai.

     

    Pēc šī pieprasījuma izpildes, grozā var redzēt esošo preci.


     

    Nākamais solis būs promo koda aktivizēšana, ja tāds ir. Šis solis nav obligāts, bet, ja klientam ir promo kods, būtu lieliski, ja būtu iespēja to izmantot.

    URL: 

    https://api.zomro.com/

    Metode: POST

    Pieprasījuma ķermenis (Form-data):

    Kādā formātā sagaidīt atbildi no API

    Parametrs Vērtības piemērs 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 veidiem. Vairāk par citiem veidiem aprakstīts šeit
    out json
    sok ok Operācijas apstiprinājums
    promocode PROMO_2024 Promo kods, kuru plānots izmantot. 
    clicked_button apply_promocode Promo koda aktivizēšanas apstiprinājums

     

    Lūk, pieprasījuma piemērs, kuru 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 promo koda aktivizēšanas rezultātu:

     

     

    Attēlā redzams, ka promo kods PROMO_2024 veiksmīgi aktivizēts. 
    PS: Patiesībā, promo kods PROMO_2024 jūsu gadījumā nav derīgs, tas tika izveidots tikai šīs instrukcijas rakstīšanai.

    Nākamais solis būs pakalpojuma aktivizēšana.

    Gadījumā, ja promo kods nesniedz 100% atlaidi, nepieciešams papildus apmaksāt pakalpojumu no personīgā konta. 

    Apskatīsim situāciju, ja promo kods nesedz 100% pakalpojuma izmaksas. API pieprasījums izskatīsies šādi:

     URL: 

    https://api.zomro.com/

    Metode: POST

    Pieprasījuma ķermenis (Form-data):

    Parametrs Vērtības piemērs 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 veidiem. Vairāk par citiem veidiem aprakstīts šeit
    out json Kādā formātā sagaidīt atbildi no API
    sok ok Operācijas apstiprinājums
    elid 1818 Pasūtījuma ID. Šī vērtība iegūta, pievienojot pakalpojumu grozam
    paymethod_id 0 Apmaksas metodes ID. Vērtība 0 ir standarta un atbilst pasūtījuma apmaksas veidam no personīgā konta līdzekļiem

     

     

    Lūk, pieprasījuma piemērs, kuru 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ā šī pakalpojuma nevajadzētu būt, kopējā CloudVPS pakalpojumu sarakstā redzam mūsu pakalpojumu statusā "Activation in progress":

     

     

    Pakalpojuma aktivizēšanas procesā papildu darbības ar pakalpojumu nav nepieciešamas. Pēc pakalpojuma aktivizēšanas mums būs pieejams darbību saraksts, lai pārvaldītu pakalpojumus, piemēram: Start, Stop, Delete, Resize un citi.
     

    Arī piedāvājam izpētīt rakstus, kas var būt noderīgi mijiedarbībai ar Cloud VPS produktiem, izmantojot API: