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

Після виконання запиту, нам потрібні дані, які знаходяться в наступній вкладеності:

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 бачимо нашу послугу в статусі "Активація в процесі":

Під час процесу активації послуги додаткові дії з послугою відсутні. Після активації послуги, у нас відкриється список доступних дій, для управління послугами, такими як: Start, Stop, Delete, Resize, та інші.
 

Також пропонуємо вивчити статті, які можуть бути корисними для взаємодії з продуктами Cloud VPS за допомогою API:

• API - Отримання інформації про доступні тарифи та їх параметри
• API - Операція Start & Stop
• API - Операція Reboot
• API - Операція Rebuild
• API - Операція Delete
• API - Взаємодія з Image
• API - Взаємодія з Backup Schedule
• API - Взаємодія з Rescue
• API - Взаємодія з Backup
• API - Взаємодія з Snapshots
• API - Взаємодія з Boot From ISO