API - Paslaugos kūrimas

Užsakant paslaugą platformoje Zomro reikia laikytis kelių svarbių etapų: paslaugos pridėjimas į krepšelį, nuolaidos kodo aktyvavimas (jei yra) ir tiesioginis paslaugos pirkimas. Šie žingsniai leidžia efektyviai naudoti nuolaidų kodų funkcionalumą užsakymo metu. Užsakymui atlikti reikia perduoti tam tikrus paslaugos parametrus, kurių išsamus aprašymas pateiktas žemiau.

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

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

Būtent tokie pirkimo etapai leidžia naudoti nuolaidų kodą užsakymo metu.

Užsakymui sukurti reikia perduoti paslaugos parametrus, kurie mus domina. Kaip gauti prieinamus parametrus, aprašyta čia.

Užsakymo struktūra paslaugai Cloud VPS Zomro:
 

URL: 

https://api.zomro.com/

Metodas: POST

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

Paslaugos užsakymo pavyzdys

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

URL: 

https://api.zomro.com/

Metodas: POST

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

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

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

doc

Štai reikšmės, gautos vykdant užklausą:

...,

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

Ši reikšmė "1818", kuri yra užsakymo numeris krepšelyje, reikalinga tolesniam paslaugos aktyvavimui. Užsirašykime ją tolesniam naudojimui.

Po šios užklausos įvykdymo krepšelyje taip pat galima pamatyti turimą prekę.

Kitas etapas bus nuolaidos kodo aktyvavimas, jei toks yra. Šis etapas nėra privalomas, tačiau 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):

Š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 įvykdymo krepšelyje galima pamatyti nuolaidos kodo aktyvavimo rezultatą:

Nuotraukoje 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 sumokėti už 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):

Š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="ok"' \
--form 'elid="1818"' \
--form 'paymethod_id="0"'

Po šios užklausos įvykdymo krepšelyje šios paslaugos neturėtų būti, bendrame CloudVPS paslaugų sąraše matome mūsų paslaugą statusu "Aktyvacija vykdoma":

Paslaugos aktyvavimo proceso metu papildomų veiksmų su paslauga nėra. Po paslaugos aktyvavimo mums atsivers prieinamų veiksmų sąrašas, skirtas paslaugoms valdyti, tokiems kaip: Pradėti, Sustabdyti, Ištrinti, Keisti dydį ir kt.
 

Taip pat siūlome susipažinti su straipsniais, kurie gali būti naudingi dirbant su Cloud VPS produktais per API:

• API - Informacijos apie prieinamus tarifus ir jų parametrus gavimas
• API - Operacija Pradėti & Sustabdyti
• API - Operacija Perkrauti
• API - Operacija Atstatyti
• API - Operacija Ištrinti
• API - Sąveika su Vaizdu
• API - Sąveika su Atsarginių kopijų tvarkaraščiu
• API - Sąveika su Gelbėjimu
• API - Sąveika su Atsargine kopija
• API - Sąveika su Momentinėmis kopijomis
• API - Sąveika su Įkrovimu iš ISO