API и CLI
API-токены
Ключ для CLI, CI и скриптов — кто создаёт, что он может и чего не может.
API-токен — ключ для программ: CLI, GitHub Actions или ваш собственный скрипт обращаются с ним к API Livops.
Создание токена
- В кабинете откройте раздел команды Настройки → API-токены (
/<команда>/settings/tokens). - Дайте токену имя (например,
github-actions) и нажмите Создать. - Токен показывается только один раз. Сразу сохраните его в секретах 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 игнорируется. Используйте токен в серверном коде или в терминале.