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 видим нашу услугу в статусе "Activation in progress":

Во время процесса активации услуги дополнительные действия с услугой отсутствуют. После активации услуги, у нас откроется список доступных действий, для управления услугами, такими как: 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