ZALOGUJ
    opened image

       W procesie zamawiania usługi na platformie Zomro należy postępować zgodnie z kilkoma ważnymi etapami: dodanie usługi do koszyka, aktywacja kodu promocyjnego (jeśli jest dostępny) oraz 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, których szczegóły przedstawiono 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):
     

    Parametr Przykładowa wartość Obowiązkowy parametr Opis wartości
    func v2.instances.order.param Tak Funkcja zamówienia usługi
    auth 21fc199...c43f71 Nie Token sesji. Jest to jedna z opcji autoryzacji. Więcej informacji o innych opcjach znajduje się tutaj
    out json Nie W jakim formacie oczekiwać odpowiedzi od API
    sok ok Tak Potwierdzenie operacji
    order_period -50 Tak Dla usług cloudvps stosuje się opłatę godzinową. Aby zrealizować zakup usługi w opłacie godzinowej, używa się wartości -50
    licence_agreement on Tak Zgoda na licencję użytkowania
    pricelist 6740 Tak ID taryfy, którą należy zamówić. ID taryfy można uzyskać z funkcji v2.instances.order.pricelist. Więcej informacji, jak korzystać, znajduje się tutaj
    order_count 1 Tak Liczba usług, które można zamówić w jednym zapytaniu
    force_use_new_cart on Tak Dodanie usługi do nowego koszyka billmanager
    instances_ssh_keys 490 Nie ID klucza SSH, który należy dodać do serwera po instalacji OS. Nie trzeba przekazywać, jeśli parametr use_ssh_key=off
    password Mypassword1 Nie Hasło dostępu do serwera. W przypadku Linux - hasło dla użytkownika root. W przypadku Windows - hasło użytkownika Administrator. Nie trzeba przekazywać, jeśli parametr use_ssh_key=on.
    Również hasło musi zawierać co najmniej 1 znak wielkiej litery angielskiej, 1 znak cyfrowy, minimalna liczba znaków to 8.  
    servername MyServer Nie Własna nazwa serwera
    instances_os 18d0ee2e-4d57-4f40-9b56-03c1773b5831 Tak UID systemu operacyjnego, który należy zainstalować. UID systemu operacyjnego można uzyskać z funkcji v2.instances.order.pricelist. Więcej informacji, jak korzystać, znajduje się tutaj
    use_ssh_key off Nie Używać klucza ssh czy nie. Może przyjmować wartości off lub on.
    addon_xxx

    260

    Nie Dodatkowe parametry usługi. Może to być RAM, liczba CPU, rozmiar dysku, ilość ruchu, typ IPv4 lub IPv6. Dostępne parametry zależą od taryfy. Dowiedzieć się, jakie opcje są dostępne, można w przykładzie opisanym tutaj

     

    Przykład zamówienia usługi

    Dla przykładu, użyjemy taryfy Cloud Essential z OS 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):

    Parametr Wartość
    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

     

    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="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 wykonaniu zapytania, potrzebne są nam dane, które znajdują się w następującej zagnieżdżoności:

    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ć dostępny produkt.


     

    Kolejnym etapem będzie aktywacja kodu promocyjnego, jeśli taki jest dostępny. Ten etap nie jest obowiązkowy, ale jeśli klient posiada kod promocyjny, warto mieć możliwość jego użycia.

    URL: 

    https://api.zomro.com/

    Metoda: POST

    Treść zapytania (Form-data):

    promocode

    Parametr Przykładowa wartość Obowiązkowy parametr Opis wartości
    func cart Tak Nazwa funkcji do pracy z koszykiem
    auth 21fc199...c43f71 Nie Token sesji. Jest to jedna z opcji autoryzacji. Więcej informacji o innych opcjach znajduje się tutaj
    out json Nie W jakim formacie oczekiwać odpowiedzi od API
    sok ok Tak Potwierdzenie operacji
    PROMO_2024 Tak Kod promocyjny, który planuje się użyć. 
    clicked_button apply_promocode Tak Potwierdzenie aktywacji kodu promocyjnego

     

    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 waszym przypadku nie jest ważny, został stworzony tylko na potrzeby tej instrukcji.

    Kolejnym etapem będzie aktywacja usługi.

    W przypadku, gdy kod promocyjny nie zapewnia 100% zniżki, należy dodatkowo opłacić usługę z konta użytkownika. 

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

     URL: 

    https://api.zomro.com/

    Metoda: POST

    Treść zapytania (Form-data):

    Parametr Przykładowa wartość Obowiązkowy parametr Opis wartości
    func cartorder.create.confirm Tak Funkcja do pracy z koszykiem
    auth 21fc199...c43f71 Nie Token sesji. Jest to jedna z opcji autoryzacji. Więcej informacji o innych opcjach znajduje się tutaj
    out json Nie W jakim formacie oczekiwać odpowiedzi od API
    sok ok Tak Potwierdzenie operacji
    elid 1818 Tak ID zamówienia. Ta wartość została uzyskana przy dodawaniu usługi do koszyka
    paymethod_id 0 Tak ID metody płatności. Wartość 0 jest standardowa i odpowiada sposobowi płatności za zamówienie z konta osobistego

     

     

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

     

     

    Po wykonaniu tego zapytania, w koszyku tej usługi nie powinno być, a na ogólnej liście usług CloudVPS widzimy naszą usługę w statusie "Activation in progress":

     

     

    Podczas procesu aktywacji usługi nie są wymagane dodatkowe działania. Po aktywacji usługi, otworzy się lista dostępnych działań do zarządzania usługami, takich jak: Start, Stop, Delete, Resize i inne.
     

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