API - მომსახურების შექმნა

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

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

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

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

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

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

URL: 

https://api.zomro.com/

მეთოდი: POST

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

მომსახურების შეკვეთის მაგალითი

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

URL: 

https://api.zomro.com/

მეთოდი: POST

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

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

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

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

doc

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

...,

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

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

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

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

URL: 

https://api.zomro.com/

მეთოდი: POST

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

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

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

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

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

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

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

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

• API - ხელმისაწვდომი ტარიფების და მათი პარამეტრების შესახებ ინფორმაციის მიღება
• API - ოპერაცია დაწყება & გაჩერება
• API - ოპერაცია გადატვირთვა
• API - ოპერაცია აღდგენა
• API - ოპერაცია წაშლა
• API - ურთიერთობა Image-თან
• API - ურთიერთობა Backup Schedule-თან
• API - ურთიერთობა Rescue-თან
• API - ურთიერთობა Backup-თან
• API - ურთიერთობა Snapshots-თან
• API - ურთიერთობა Boot From ISO-თან