← Каталог интеграций

FirstVDS

v1.0.0 firstvds 15.6 КБ 14 коннекторов

Пакет для Flow Manager

pack-firstvds.usint

SHA-256 · a90a2277ecf0…

Скачать .usint

О вендоре FirstVDS и решении

FirstVDS — российский провайдер виртуальных выделенных серверов (VDS/VPS) и облачной инфраструктуры на платформе BILLmanager. Клиенты FirstVDS управляют парком виртуальных машин, тарифами, IP-адресами и платежами через личный кабинет my.firstvds.ru; для автоматизации доступен HTTP API биллинга.

Пакет коннекторов UniShift Flow Manager работает с BILLmanager API FirstVDS (authinfo + JSON out). Коннекторы позволяют получать список виртуальных серверов и их параметры, управлять питанием (старт / стоп / reboot / rescue), читать IP-адреса услуги, выгружать платежи и расходы, смотреть баланс лицевого счёта, список тикетов поддержки и данные реферальной программы (ссылка, промокод, статистика переходов и вознаграждений). Логин и пароль кабинета хранятся только в {{env.*}} (Настройки → Окружения), в сценарии Flow они не передаются как пользовательские поля.

Реферальная программа FirstVDS: партнёр получает 10% от расходов привлечённых клиентов, реферал — скидку 25% на первый месяц. Ссылка и промокод читаются из раздела «Клиент → Реферальная программа» через func=affiliate.client.

Типовые сценарии: инвентаризация VDS в мониторинге и тикетах, автоперезагрузка или стоп при алерте health-check, сверка платежей/расходов с финансами в 1С/МойСклад, уведомление в Telegram/MAX при статусе услуги или низком балансе, выгрузка реферальной ссылки в маркетинговые сценарии.

Пакет разработан по стандартам корпоративной безопасности и отказоустойчивости UniShift Platform. Поддерживается непрерывный мониторинг состояния подключений, автоматическая ротация ключей и токенов доступа, сквозное шифрование трафика (TLS 1.3), а также изоляция секретов в защищенном хранилище. Архитектура коннекторов включает встроенный механизм буферизации повторных попыток (Retry Policy) и кэширование справочных данных, что гарантирует надежную работу бизнес-процессов даже при кратковременных сбоях на стороне внешнего API.

Возможности интеграционного пакета

  • Получение полного списка виртуальных серверов (VDS/VPS) аккаунта FirstVDS
  • {'Чтение карточки конкретного VDS': 'тариф, IP, статус, ресурсы'}
  • Включение, выключение и перезагрузка VDS через BILLmanager API
  • Переход в режим восстановления (rescue) и выход из него
  • Список IP-адресов, привязанных к услуге VDS
  • Баланс лицевого счёта и выгрузка платежей / расходов
  • Список обращений в поддержку (тикеты)
  • {'Реферальная программа': 'ссылка и промокод партнёра (affiliate.client)'}
  • Статистика реферальных переходов (affiliate.client.click)
  • Начисления по реферальной программе (affiliate.client.reward)
  • Хранение учётных данных биллинга только в защищённом окружении {{env.*}}
  • Использование в сценариях алертов, инвентаризации, финансов и партнёрки
  • Повтор запросов при кратковременных сбоях API и детальное логирование шагов

Коннекторы в пакете

API-ключи и секреты сохраняйте в платформе: Настройки → Окружения. В сценарии подключите узел «Окружение» — переменные станут доступны как {{env.KEY}}.

FirstVDS · Баланс счёта

firstvds-get-balance

out · firstvds

Получить лицевые счета аккаунта и текущий баланс

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Реферальная программа

firstvds-get-referral

out · firstvds

Получить реферальную ссылку и промокод партнёра (Клиент → Реферальная программа). Партнёр получает 10% от расходов рефералов; реферал — скидку 25% на первый месяц.

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Информация о VDS

firstvds-get-vds-info

out · firstvds

Получить детальную информацию по конкретному виртуальному серверу

Параметры (inputs)

Поле Ключ Тип
ID сервера (elid) vds_id string обяз.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Список расходов

firstvds-list-expenses

out · firstvds

Получить историю списаний (expense) с лицевого счёта

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · IP-адреса VDS

firstvds-list-ips

out · firstvds

Получить список IP-адресов, привязанных к услуге VDS

Параметры (inputs)

Поле Ключ Тип
ID сервера (elid / plid) vds_id string обяз.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Список платежей

firstvds-list-payments

out · firstvds

Получить историю платежей и списаний с личного счёта

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Список тикетов

firstvds-list-tickets

out · firstvds

Получить список обращений в поддержку (clientticket)

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Список VDS серверов

firstvds-list-vds

out · firstvds

Получить список всех виртуальных серверов (VDS/VPS) аккаунта

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Перезагрузить VDS

firstvds-reboot-vds

out · firstvds

Отправить команду перезагрузки VDS (vds.reboot.confirm)

Параметры (inputs)

Поле Ключ Тип
ID сервера (elid) vds_id string обяз.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Рефералка · Переходы

firstvds-referral-clicks

out · firstvds

Статистика переходов по реферальной ссылке / промокоду (Клиент → Реферальная программа → Статистика, func=affiliate.client.click). Поля: cdate, site, referal, payed.

Параметры (inputs)

Без пользовательских полей

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Рефералка · Вознаграждения

firstvds-referral-rewards

out · firstvds

Начисления по реферальной программе по месяцам (Клиент → Реферальная программа → Вознаграждение, func=affiliate.client.reward). Поля: cdate, amount.

Параметры (inputs)

Поле Ключ Тип
Период отчёта period select опц.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Режим восстановления VDS

firstvds-rescue-vds

out · firstvds

Включить или выключить rescue-режим виртуального сервера

Параметры (inputs)

Поле Ключ Тип
ID сервера (elid) vds_id string обяз.
Режим восстановления rescue_mode select обяз.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Включить VDS

firstvds-start-vds

out · firstvds

Включить (resume) виртуальный сервер через BILLmanager API

Параметры (inputs)

Поле Ключ Тип
ID сервера (elid) vds_id string обяз.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

FirstVDS · Выключить VDS

firstvds-stop-vds

out · firstvds

Принудительно остановить (suspend.confirm) виртуальный сервер

Параметры (inputs)

Поле Ключ Тип
ID сервера (elid) vds_id string обяз.
Принудительно (on/off) force select опц.

Переменные окружения

Переменная Назначение Значение Где взять
FIRSTVDS_API_URL Хост API BILLmanager FirstVDS https://my.firstvds.ru/billmgr Документация FirstVDS / my.firstvds.ru
FIRSTVDS_PASSWORD Пароль личного кабинета FirstVDS (BILLmanager) Пароль аккаунта биллинга FirstVDS FirstVDS → Личный кабинет my.firstvds.ru
FIRSTVDS_USER Логин личного кабинета FirstVDS (BILLmanager) Ваш email или логин в биллинге FirstVDS FirstVDS → Личный кабинет my.firstvds.ru

API: GET /api/integrations/pack-firstvds · GET /api/integrations/pack-firstvds/download