API - Tworzenie usługi

W procesie zamawiania usługi na platformie Zomro należy przejść przez kilka ważnych etapów: dodanie usługi do koszyka, aktywacja kodu promocyjnego (jeśli jest dostępny) oraz bezpośrednio zakup usługi. Te kroki pozwalają efektywnie wykorzystać funkcjonalność kodów promocyjnych podczas zamówienia. Aby zrealizować zamówienie, należy przekazać określone parametry usługi, szczegóły dotyczące których przedstawione są poniżej.

Proces tworzenia zamówienia składa się z następujących etapów:

• Dodanie usługi do koszyka
• Aktywacja kodu promocyjnego
• Zakup usługi z koszyka

Użycie właśnie takich etapów zakupu pozwala na wykorzystanie kodu promocyjnego podczas zamówienia.

Aby stworzyć zamówienie, należy przekazać parametry usługi, które nas interesują. Jak uzyskać dostępne parametry, opisano tutaj. 

Struktura zapytania do realizacji zamówienia usługi Cloud VPS Zomro:
 

URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):
 

Przykład zamówienia usługi

Dla przykładu, użyjemy taryfy Cloud Essential z systemem operacyjnym Linux Ubuntu 20.04, serwer tylko z IPv6 i z użyciem hasła użytkownika root.

URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Oto przykład zapytania, które można wykonać z konsoli:

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 wykonaniu zapytania, potrzebne są dane, które znajdują się w następującej zagnieżdżonej strukturze:

doc

Oto wartości, które uzyskano w wyniku wykonania zapytania:

...,

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

Ta wartość "1818", która jest numerem zamówienia w koszyku, jest potrzebna do dalszej aktywacji usługi. Zapamiętajmy ją do dalszego użycia.

Po wykonaniu tego zapytania, w koszyku można również zobaczyć posiadany towar.

Następnym etapem będzie aktywacja kodu promocyjnego, jeśli taki istnieje. Ten etap nie jest obowiązkowy, ale jeśli klient ma kod promocyjny, byłoby wspaniale mieć możliwość jego użycia.

URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Oto przykład zapytania, które można wykonać z konsoli:

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 wykonaniu tego zapytania, w koszyku można zobaczyć wynik aktywacji kodu promocyjnego:

Na obrazku widać, że kod promocyjny PROMO_2024 został pomyślnie aktywowany. 
PS: W rzeczywistości, kod promocyjny PROMO_2024, w twoim przypadku, nie jest ważny, został stworzony tylko na potrzeby napisania tej instrukcji.

Następnym etapem będzie aktywacja usługi.

W przypadku, gdy kod promocyjny nie pokrywa 100% kosztów, należy dodatkowo opłacić usługę z panelu użytkownika. 

Rozważmy sytuację, gdy kod promocyjny nie pokrywa 100% kosztów usługi. Zapytanie API będzie wyglądać następująco:

 URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Oto przykład zapytania, które można wykonać z konsoli:

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 wykonaniu tego zapytania, w koszyku tej usługi nie powinno być, w ogólnym wykazie usług CloudVPS widzimy naszą usługę w statusie "Aktywacja w toku":

W trakcie procesu aktywacji usługi dodatkowe działania z usługą są niedostępne. Po aktywacji usługi, otworzy się lista dostępnych działań do zarządzania usługami, takich jak: Start, Stop, Delete, Resize i inne.
 

Zachęcamy również do zapoznania się z artykułami, które mogą być przydatne w interakcji z produktami Cloud VPS za pomocą API:

• API - Uzyskiwanie informacji o dostępnych taryfach i ich parametrach
• API - Operacja Start & Stop
• API - Operacja Reboot
• API - Operacja Rebuild
• API - Operacja Delete
• API - Interakcja z Image
• API - Interakcja z Harmonogramem Kopii Zapasowych
• API - Interakcja z Rescue
• API - Interakcja z Backup
• API - Interakcja z Snapshots
• API - Interakcja z Boot From ISO