Представляем Livops 2.0! ПромокодCEOдарит 8 000 сумов на ваш счёт.Что нового
API и CLI / API-токены

API и CLI

API-токены

Ключ для CLI, CI и скриптов — кто создаёт, что он может и чего не может.

API-токен — ключ для программ: CLI, GitHub Actions или ваш собственный скрипт обращаются с ним к API Livops.

Создание токена

  1. В кабинете откройте раздел команды Настройки → API-токены (/<команда>/settings/tokens).
  2. Дайте токену имя (например, github-actions) и нажмите Создать.
  3. Токен показывается только один раз. Сразу сохраните его в секретах CI или в менеджере паролей.

Правила:

  • Токен создаёт только владелец команды (owner).
  • Один токен — одна команда. Токен видит только проекты этой команды; запрос к проекту другой команды вернёт 404.
  • Токен начинается с lvp_. Livops хранит только его хеш.
  • Срока действия нет — токен работает, пока его не отзовут. До 20 активных токенов на аккаунт.
  • Время последнего использования видно в списке. Ненужный или раскрытый токен сразу отзовите.
  • Если владелец токена покидает команду, токен перестаёт работать.

Использование

Передавайте токен в заголовке Authorization:

curl https://livops.uz/api/projects \
  -H 'Authorization: Bearer lvp_xxx'

Никогда не записывайте токен в код или репозиторий — храните его в переменной окружения (LIVOPS_TOKEN).

Что токен может

  • Читать почти всё: проекты, деплои, логи, список баз данных, домены.
  • Изменять — только в рамках projects, deploys и stacks: деплоить, задавать переменные, добавлять сервисы и окружения, делать promote.

Что токен не может

Следующее доступно только человеку в кабинете (с сессией браузера) — с токеном вернётся 403:

  • удалять что-либо (запросы DELETE);
  • создавать, просматривать или отзывать токены — токен не может выпустить другой токен;
  • пароль, сессии, двухфакторная аутентификация и настройки аккаунта;
  • команда, участники, биллинг и платежи;
  • изменение общих переменных окружения;
  • передача проекта и изменение участников проекта;
  • данные подключения к базе (пароль) и резервные копии;
  • управление deploy hook, вебхуками, пересылкой логов и SSH-ключами.

Полный список отмечен у каждого эндпоинта в справочнике API.

Не из браузера

Если в запросе есть заголовки Cookie, Origin или Sec-Fetch-* (то есть он выглядит как пришедший из браузера), заголовок Authorization игнорируется. Используйте токен в серверном коде или в терминале.

Есть вопрос? — @livops_uz