PRISIJUNGTI
    opened image

    Užsakant paslaugą Zomro platformoje, būtina laikytis kelių svarbių etapų: paslaugos pridėjimas į krepšelį, nuolaidos kodo aktyvavimas (jei yra), ir tiesioginis paslaugos pirkimas. Šie žingsniai leidžia efektyviai naudoti nuolaidos kodus užsakymo metu. Norint atlikti užsakymą, būtina perduoti tam tikrus paslaugos parametrus, kurių detalės pateiktos žemiau.

    Užsakymo kūrimo procesas susideda iš šių etapų:

    • Paslaugos pridėjimas į krepšelį
    • Nuolaidos kodo aktyvavimas
    • Paslaugos pirkimas iš krepšelio

    Naudojant būtent tokius pirkimo etapus, galima naudoti nuolaidos kodą užsakymo metu.

    Norint sukurti užsakymą, reikia perduoti mus dominančius paslaugos parametrus. Kaip gauti prieinamus parametrus, aprašyta čia

     

    Užsakymo užklausos struktūra Cloud VPS Zomro paslaugai:
     

    URL: 

    https://api.zomro.com/

    Metodas: POST

    Užklausos kūnas (Form-data):
     

    Parametras Vertės pavyzdys Privalomas parametras Vertės aprašymas
    func v2.instances.order.param Taip Paslaugos užsakymo funkcija
    auth 21fc199...c43f71 Ne Sesijos žetonas. Tai vienas iš autorizacijos būdų. Daugiau apie kitus būdus aprašyta čia
    out json Ne Kokiu formatu laukti atsakymo iš API
    sok ok Taip Operacijos patvirtinimas
    order_period -50 Taip Cloudvps paslaugoms naudojamas valandinis apmokėjimas. Norint atlikti pirkimą valandiniu apmokėjimu, naudojama vertė -50
    licence_agreement on Taip Atitinka sutikimą su licencijos naudojimu
    pricelist 6740 Taip Tarifo ID, kurį reikia užsakyti. Tarifo ID galima gauti iš funkcijos v2.instances.order.pricelist. Daugiau apie naudojimą aprašyta čia
    order_count 1 Taip Paslaugų kiekis, kurį galima užsakyti vienoje užklausoje
    force_use_new_cart on Taip Paslaugos pridėjimas į naują billmanager krepšelį
    instances_ssh_keys 490 Ne SSH rakto ID, kurį reikia pridėti prie serverio po OS įdiegimo. Nereikia perduoti, jei parametras use_ssh_key=off
    password Mypassword1 Ne Prieigos prie serverio slaptažodis. Linux atveju - root vartotojo slaptažodis. Windows atveju - Administrator vartotojo slaptažodis. Nereikia perduoti, jei parametras use_ssh_key=on.
    Be to, slaptažodis turi turėti bent 1 didžiąją anglų kalbos raidę, 1 skaitmeninį simbolį, minimalus simbolių skaičius 8.  
    servername MyServer Ne Serverio pavadinimas
    instances_os 18d0ee2e-4d57-4f40-9b56-03c1773b5831 Taip OS UID, kurią reikia įdiegti. OS UID galima gauti iš funkcijos v2.instances.order.pricelist. Daugiau apie naudojimą aprašyta čia
    use_ssh_key off Ne Naudoti ssh raktą ar ne. Gali priimti vertes off arba on.
    addon_xxx

    260

    Ne Papildomi paslaugos parametrai. Gali būti RAM, CPU kiekis, disko dydis, srauto apimtis, IPv4 arba IPv6 tipas. Prieinami parametrai priklauso nuo tarifo. Sužinoti, kokios parinktys yra prieinamos, galima pavyzdyje, aprašytame čia

     

    Paslaugos užsakymo pavyzdys

    Pavyzdžiui, naudojame Cloud Essential tarifą su Linux Ubuntu 20.04 OS, serverį tik su IPv6 ir root vartotojo slaptažodžiu.

    URL: 

    https://api.zomro.com/

    Metodas: POST

     

    Užklausos kūnas (Form-data):

    Parametras Vertė
    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

     

    Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:

    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"'

     

    Po užklausos atlikimo, mums reikia duomenų, kurie yra šioje struktūroje:

    doc

     

    Štai vertės, gautos atlikus užklausą:

    ...,
    
    "lineitem.id": {
        "$": "1818"
    },
    ...
    

     

     

    Ši vertė "1818", kuri yra užsakymo numeris krepšelyje, reikalinga tolesnei paslaugos aktyvacijai. Prisiminkime ją tolesniam naudojimui.

     

    Po šios užklausos atlikimo, krepšelyje taip pat galima matyti esamą prekę.


     

    Kitas etapas bus nuolaidos kodo aktyvavimas, jei toks yra. Šis etapas nėra privalomas, bet jei klientas turi nuolaidos kodą, būtų puiku turėti galimybę jį naudoti.

    URL: 

    https://api.zomro.com/

    Metodas: POST

    Užklausos kūnas (Form-data):

    Parametras Vertės pavyzdys Privalomas parametras Vertės aprašymas
    func cart Taip Funkcijos pavadinimas darbui su krepšeliu
    auth 21fc199...c43f71 Ne Sesijos žetonas. Tai vienas iš autorizacijos būdų. Daugiau apie kitus būdus aprašyta čia
    out json Ne Kokiu formatu laukti atsakymo iš API
    sok ok Taip Operacijos patvirtinimas
    promocode PROMO_2024 Taip Nuolaidos kodas, kurį planuojama naudoti. 
    clicked_button apply_promocode Taip Nuolaidos kodo aktyvavimo patvirtinimas

     

    Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:

    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"'

     

    Po šios užklausos atlikimo, krepšelyje galima matyti nuolaidos kodo aktyvavimo rezultatą:

     

     

    Paveikslėlyje matyti, kad nuolaidos kodas PROMO_2024 sėkmingai aktyvuotas. 
    PS: Iš tikrųjų, nuolaidos kodas PROMO_2024, jūsų atveju, nėra galiojantis, jis buvo sukurtas tik šios instrukcijos rašymui.

    Kitas etapas bus paslaugos aktyvavimas.

    Jei nuolaidos kodas nesuteikia 100% nuolaidos, reikia papildomai apmokėti paslaugą iš asmeninės paskyros. 

    Apsvarstykime situaciją, jei nuolaidos kodas nepadengia 100% paslaugos kainos. API užklausa atrodys taip:

     URL: 

    https://api.zomro.com/

    Metodas: POST

    Užklausos kūnas (Form-data):

    Parametras Vertės pavyzdys Privalomas parametras Vertės aprašymas
    func cartorder.create.confirm Taip Funkcija darbui su krepšeliu
    auth 21fc199...c43f71 Ne Sesijos žetonas. Tai vienas iš autorizacijos būdų. Daugiau apie kitus būdus aprašyta čia
    out json Ne Kokiu formatu laukti atsakymo iš API
    sok ok Taip Operacijos patvirtinimas
    elid 1818 Taip Užsakymo ID. Ši vertė gauta pridedant paslaugą į krepšelį
    paymethod_id 0 Taip Apmokėjimo metodo ID. Vertė 0 yra standartinė ir atitinka apmokėjimo būdą iš asmeninės sąskaitos lėšų

     

     

    Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:

     

    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"'

     

     

    Po šios užklausos atlikimo, krepšelyje šios paslaugos neturėtų būti, bendrame CloudVPS paslaugų sąraše matome mūsų paslaugą su statusu "Activation in progress":

     

     

    Paslaugos aktyvavimo proceso metu papildomų veiksmų su paslauga nėra. Po paslaugos aktyvavimo, mums atsivers prieinamų veiksmų sąrašas, skirtas paslaugų valdymui, tokių kaip: Start, Stop, Delete, Resize, ir kiti.
     

    Taip pat siūlome susipažinti su straipsniais, kurie gali būti naudingi sąveikai su Cloud VPS produktais naudojant API: