Шаблоны

Шаблоны

Шаблоны позволяют генерировать как однострочные команды, так и целые блоки текста. Эти механизмы являются основой построения взаимодействий SHM.

Синтаксис: {{ ОБЪЕКТ.ДАННЫЕ }}

Например, с помощью объекта user можно получить доступ к данным пользователя:

• user.id - идентификатор пользователя
• user.login - логин пользователя
• user.balance - баланс пользователя

С помощью объекта us можно получить доступ к текущей услуге пользователя, и к ее данным:

• us.id - идентификатор пользовательской услуги
• us.expire - дата истечения услуги
• us.service.cost - стоимость услуги
• us.settings.КЛЮЧ - читаем произвольное поле (КЛЮЧ для примера) из данных услуги

Полный список объектов вы можете найти здесь: Объекты и функции

Пример выполнения shell команды:

add_new_vpn.sh --login=vpn_{{ us.id }} --password={{ us.gen_store_pass }}

В этом примере мы использовали:

• Идентификатор пользовательской услуги us.id
• специальную функцию us.gen_store_pass, которая сгенерирует случайный пароль и сохранит его в настройках пользовательской услуги (поле password).

Таким образом, на сервере будет выполнена такая команда (пример):

add_new_vpn.sh --login=vpn_1234 --password=abcdefjh

Пример выполнения shell скрипта:

Иногда удобнее выполнить целый скрипт, многострочный кусок кода. В таких случаях, можно создать отдельный шаблон, тогда в качестве команды мы можем указать следующий код:

bash <(curl -s -H 'session-id: {{ user.gen_session.id }}' {{ config.api.url }}/shm/v1/template/my_bash_script?format=plain)

Данная команда скачает шаблон с имененем my_bash_script на сервер и выполнит его.

Подробнее о создании и настройке шаблонов можно прочитать здесь и здесь

Условия и циклы

В шаблонах поддерживаются условия и циклы.

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

Больше информации об условиях и циклах Вы можете узнать здесь

Объекты и функции