API - Paslaugos kūrimas

Užsakant paslaugą platformoje Zomro, 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 nuolaidų kodų funkcionalumą 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

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

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

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

URL:

https://api.zomro.com/

Metodas: POST

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

Parametras	Pavyzdžio reikšmė	Privalomas parametras	Reikšmės aprašymas
func	v2.instances.order.param	Taip	Paslaugos užsakymo funkcija
auth	21fc199...c43f71	Ne	Sesijos žetonas. Tai vienas iš autorizacijos variantų. Išsamesnė informacija apie kitus variantus pateikta čia
out	json	Ne	Kokiu formatu tikėtis atsakymo iš API
sok	ok	Taip	Operacijos patvirtinimas
order_period	-50	Taip	CloudVPS paslaugoms taikomas kasdienis atsiskaitymas. Paslaugos pirkimui naudokite reikšmę: -50, 1, 3, 6, 12. -50 - kasdienis atsiskaitymas, 1 - paslaugos užsakymas 1 mėnesiui, 3 - užsakymas 3 mėnesiams ir taip toliau.
licence_agreement	on	Taip	Atitinka sutikimą su naudojimo licencija
pricelist	6740	Taip	ID tarifas, kurį reikia užsakyti. Tarifų ID galima gauti iš funkcijos v2.instances.order.pricelist. Išsamesnė informacija apie naudojimą pateikta čia
order_count	1	Taip	Paslaugų skaičius, kurias galima užsakyti vienu užklausimu
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 slaptažodis prie serverio. Linux atveju - slaptažodis vartotojui root. 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 skaitmenį, minimalus simbolių skaičius - 8.
servername	MyServer	Ne	Asmeninis serverio pavadinimas
instances_os	18d0ee2e-4d57-4f40-9b56-03c1773b5831	Taip	Operacinės sistemos UID, kurią reikia įdiegti. Operacinės sistemos UID galima gauti iš funkcijos v2.instances.order.pricelist. Išsamesnė informacija apie naudojimą pateikta čia
use_ssh_key	off	Ne	Naudoti SSH raktą ar ne. Gali priimti reikšmes off arba on.
addon_xxx	260	Ne	Papildomi paslaugos parametrai. Gali būti RAM, CPU skaičius, disko dydis, duomenų srauto apimtis, IPv4 arba IPv6 tipas. Prieinami parametrai priklauso nuo tarifo. Sužinoti, kokios parinktys yra prieinamos, galima pavyzdyje, aprašytame čia
datacenter	13	Taip	Duomenų centro numeris. Sužinoti, kokios parinktys yra prieinamos, galima pavyzdyje, aprašytame čia

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

Parametras	Reikšmė
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

Š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 'datacenter="13"' \
--form 'force_use_new_cart="on"'

Po užklausos įvykdymo, mums reikalingi duomenys, 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):

Parametras	Pavyzdžio reikšmė	Privalomas parametras	Reikšmės aprašymas
func	cart	Taip	Funkcijos pavadinimas, skirtas dirbti su krepšeliu
auth	21fc199...c43f71	Ne	Sesijos žetonas. Tai vienas iš autorizacijos variantų. Išsamesnė informacija apie kitus variantus pateikta čia
out	json	Ne	Kokiu formatu tikėtis 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 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):

Parametras	Pavyzdžio reikšmė	Privalomas parametras	Reikšmės aprašymas
func	cartorder.create.confirm	Taip	Funkcija, skirta dirbti su krepšeliu
auth	21fc199...c43f71	Ne	Sesijos žetonas. Tai vienas iš autorizacijos variantų. Išsamesnė informacija apie kitus variantus pateikta čia
out	json	Ne	Kokiu formatu tikėtis atsakymo iš API
sok	ok	Taip	Operacijos patvirtinimas
elid	1818	Taip	Užsakymo ID. Ši reikšmė gauta pridedant paslaugą į krepšelį
paymethod_id	0	Taip	Mokėjimo metodo ID. Reikšmė 0 yra standartinė ir atitinka užsakymo apmokėjimą 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 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 paslaugų valdymui, tokiems kaip: Pradėti, Sustabdyti, Ištrinti, Perkelti ir kiti.

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