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:
- API - Informacijos apie galimus tarifus ir jų parametrus gavimas
- API - Operacija Start & Stop
- API - Operacija Reboot
- API - Operacija Rebuild
- API - Operacija Delete
- API - Sąveika su Backup Schedule
- API - Sąveika su Rescue
- API - Sąveika su Backup
- API - Sąveika su Snapshots
- API - Sąveika su Boot From ISO
- API - Sąveika su Image