შესვლა
    opened image

       პლატფორმა Zomro-ზე სერვისის შეკვეთის პროცესში აუცილებელია რამდენიმე მნიშვნელოვანი ეტაპის დაცვა: სერვისის კალათაში დამატება, პრომოკოდის გააქტიურება (არსებობის შემთხვევაში) და უშუალოდ სერვისის შეძენა. ეს ნაბიჯები საშუალებას იძლევა ეფექტურად გამოიყენოთ პრომოკოდების ფუნქციონალი შეკვეთის დროს. შეკვეთის განსახორციელებლად საჭიროა სერვისის გარკვეული პარამეტრების გადაცემა, რომლის დეტალები ქვემოთ არის წარმოდგენილი.

    შეკვეთის შექმნის პროცესი შედგება შემდეგი ეტაპებისგან:

    • სერვისის კალათაში დამატება
    • პრომოკოდის გააქტიურება
    • სერვისის შეძენა კალათიდან

    შეკვეთის სწორედ ასეთი ეტაპების გამოყენება საშუალებას იძლევა გამოიყენოთ პრომოკოდი შეკვეთის დროს.

    შეკვეთის შესაქმნელად საჭიროა გადაცემა იმ სერვისის პარამეტრების, რომლებიც გვაინტერესებს. როგორ მივიღოთ ხელმისაწვდომი პარამეტრები, აღწერილია აქ

     

    Cloud VPS Zomro სერვისის შეკვეთის მოთხოვნის სტრუქტურა:
     

    URL: 

    https://api.zomro.com/

    მეთოდი: POST

    მოთხოვნის სხეული (Form-data):
     

    პარამეტრი მნიშვნელობის მაგალითი სავალდებულო პარამეტრი მნიშვნელობის აღწერა
    func v2.instances.order.param დიახ სერვისის შეკვეთის ფუნქცია
    auth 21fc199...c43f71 არა სესიის ტოკენი. ეს არის ავტორიზაციის ერთ-ერთი ვარიანტი. დაწვრილებით, რა სხვა ვარიანტები არსებობს, აღწერილია აქ
    out json არა რა ფორმატში ველოდოთ API-ის პასუხს
    sok ok დიახ ოპერაციის დადასტურება
    order_period -50 დიახ cloudvps სერვისებისთვის გამოიყენება საათობრივი გადახდა. საათობრივი გადახდის სერვისის შესაძენად გამოიყენება მნიშვნელობა -50
    licence_agreement on დიახ ლიცენზიის გამოყენების თანხმობა
    pricelist 6740 დიახ ტარიფის ID, რომელიც უნდა შეუკვეთოთ. ტარიფის ID შეგიძლიათ მიიღოთ ფუნქციიდან v2.instances.order.pricelist. დაწვრილებით, როგორ გამოიყენოთ, აღწერილია აქ
    order_count 1 დიახ სერვისების რაოდენობა, რომელიც შეგიძლიათ შეუკვეთოთ ერთ მოთხოვნაში
    force_use_new_cart on დიახ სერვისის დამატება ახალ კალათაში billmanager-ში
    instances_ssh_keys 490 არა SSH გასაღების ID, რომელიც უნდა დაემატოს სერვერს OS-ის ინსტალაციის შემდეგ. არ არის საჭირო გადაცემა, თუ პარამეტრი use_ssh_key=off
    password Mypassword1 არა სერვერის წვდომის პაროლი. Linux-ის შემთხვევაში - root მომხმარებლის პაროლი. Windows-ის შემთხვევაში - Administrator მომხმარებლის პაროლი. არ არის საჭირო გადაცემა, თუ პარამეტრი use_ssh_key=on.
    ასევე, პაროლი უნდა შეიცავდეს მინიმუმ 1 დიდ ასოს, 1 ციფრულ სიმბოლოს, მინიმალური სიმბოლოების რაოდენობა 8.  
    servername MyServer არა სერვერის საკუთარი სახელი
    instances_os 18d0ee2e-4d57-4f40-9b56-03c1773b5831 დიახ ოპერაციული სისტემის UID, რომელიც უნდა დაინსტალირდეს. ოპერაციული სისტემის UID შეგიძლიათ მიიღოთ ფუნქციიდან v2.instances.order.pricelist. დაწვრილებით, როგორ გამოიყენოთ, აღწერილია აქ
    use_ssh_key off არა ssh გასაღების გამოყენება თუ არა. შეიძლება მიიღოს მნიშვნელობები off ან on.
    addon_xxx

    260

    არა სერვისის დამატებითი პარამეტრები. შეიძლება იყოს RAM, CPU რაოდენობა, დისკის ზომა, ტრაფიკის მოცულობა, IPv4 ან IPv6 ტიპი. ხელმისაწვდომი პარამეტრები დამოკიდებულია ტარიფზე. რა ოპციები არის ხელმისაწვდომი, შეგიძლიათ გაიგოთ მაგალითში, აღწერილი აქ

     

    სერვისის შეკვეთის მაგალითი

    მაგალითისთვის, გამოვიყენოთ Cloud Essential ტარიფი Linux Ubuntu 20.04 ოპერაციული სისტემით, სერვერი მხოლოდ IPv6-ით და root მომხმარებლის პაროლის გამოყენებით.

    URL: 

    https://api.zomro.com/

    მეთოდი: POST

     

    მოთხოვნის სხეული (Form-data):

    პარამეტრი მნიშვნელობა
    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

     

    აი მაგალითი მოთხოვნის, რომელიც შეგიძლიათ შეასრულოთ კონსოლიდან:

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

     

    მოთხოვნის შესრულების შემდეგ, ჩვენ გვჭირდება მონაცემები, რომლებიც შემდეგი ჩაშენებულობის დონეზეა:

    doc

     

    აი მნიშვნელობები, რომლებიც მიღებულია მოთხოვნის შესრულების შედეგად:

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

     

     

    ეს მნიშვნელობა "1818", რომელიც არის შეკვეთის ნომერი კალათაში, საჭიროა სერვისის შემდგომი გააქტიურებისთვის. დავიმახსოვროთ ის შემდგომი გამოყენებისთვის.

     

    ამ მოთხოვნის შესრულების შემდეგ, კალათაში ასევე შეგიძლიათ ნახოთ არსებული პროდუქტი.


     

    შემდეგი ეტაპი იქნება პრომოკოდის გააქტიურება, თუ ის არსებობს. ეს ეტაპი არ არის სავალდებულო, მაგრამ თუ კლიენტს აქვს პრომოკოდი, კარგი იქნება მისი გამოყენების შესაძლებლობა.

    URL: 

    https://api.zomro.com/

    მეთოდი: POST

    მოთხოვნის სხეული (Form-data):

    პარამეტრი მნიშვნელობის მაგალითი სავალდებულო პარამეტრი მნიშვნელობის აღწერა
    func cart დიახ კალათასთან მუშაობის ფუნქციის სახელი
    auth 21fc199...c43f71 არა სესიის ტოკენი. ეს არის ავტორიზაციის ერთ-ერთი ვარიანტი. დაწვრილებით, რა სხვა ვარიანტები არსებობს, აღწერილია აქ
    out json არა რა ფორმატში ველოდოთ API-ის პასუხს
    sok ok დიახ ოპერაციის დადასტურება
    promocode PROMO_2024 დიახ პრომოკოდი, რომელიც იგეგმება გამოყენება. 
    clicked_button apply_promocode დიახ პრომოკოდის გააქტიურების დადასტურება

     

    აი მაგალითი მოთხოვნის, რომელიც შეგიძლიათ შეასრულოთ კონსოლიდან:

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

     

    მოთხოვნის შესრულების შემდეგ, კალათაში შეგიძლიათ ნახოთ პრომოკოდის გააქტიურების შედეგი:

     

     

    სურათზე ჩანს, რომ პრომოკოდი PROMO_2024 წარმატებით გააქტიურდა. 
    PS: სინამდვილეში, პრომოკოდი PROMO_2024 თქვენს შემთხვევაში არ არის მოქმედი, ის შეიქმნა მხოლოდ ამ ინსტრუქციის დასაწერად.

    შემდეგი ეტაპი იქნება სერვისის გააქტიურება.

    იმ შემთხვევაში, თუ პრომოკოდი არ უზრუნველყოფს 100% ფასდაკლებას, საჭიროა დამატებით სერვისის გადახდა პირადი ანგარიშიდან. 

    განვიხილოთ სიტუაცია, თუ პრომოკოდი არ ფარავს სერვისის 100% ღირებულებას. API მოთხოვნა იქნება შემდეგნაირი:

     URL: 

    https://api.zomro.com/

    მეთოდი: POST

    მოთხოვნის სხეული (Form-data):

    პარამეტრი მნიშვნელობის მაგალითი სავალდებულო პარამეტრი მნიშვნელობის აღწერა
    func cartorder.create.confirm დიახ კალათასთან მუშაობის ფუნქცია
    auth 21fc199...c43f71 არა სესიის ტოკენი. ეს არის ავტორიზაციის ერთ-ერთი ვარიანტი. დაწვრილებით, რა სხვა ვარიანტები არსებობს, აღწერილია აქ
    out json არა რა ფორმატში ველოდოთ API-ის პასუხს
    sok ok დიახ ოპერაციის დადასტურება
    elid 1818 დიახ შეკვეთის ID. ეს მნიშვნელობა მიღებულია სერვისის კალათაში დამატებისას
    paymethod_id 0 დიახ გადახდის მეთოდის ID. მნიშვნელობა 0 არის სტანდარტული და შეესაბამება შეკვეთის გადახდის მეთოდს პირადი ანგარიშის თანხებით

     

     

    აი მაგალითი მოთხოვნის, რომელიც შეგიძლიათ შეასრულოთ კონსოლიდან:

     

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

     

     

    მოთხოვნის შესრულების შემდეგ, კალათაში ამ სერვისის არ უნდა იყოს, საერთო სერვისების სიაში CloudVPS ვხედავთ ჩვენს სერვისს სტატუსით "Activation in progress":

     

     

    სერვისის გააქტიურების პროცესში დამატებითი ქმედებები სერვისთან არ არის საჭირო. სერვისის გააქტიურების შემდეგ, ჩვენ გვექნება ხელმისაწვდომი ქმედებების სია, სერვისების მართვისთვის, როგორიცაა: Start, Stop, Delete, Resize და სხვა.
     

    ასევე გთავაზობთ შეისწავლოთ სტატიები, რომლებიც შეიძლება სასარგებლო იყოს Cloud VPS პროდუქტებთან API-ის გამოყენებით: