API и CLI
Деплой из вашего приложения (для партнёров)
Для платформ, которые создают сайты: пользователь один раз подключает Livops, а кнопка «Deploy» отправляет файлы прямо в Livops.
Эта страница для платформ, которые создают сайты и приложения (AI app builder, конструктор, IDE). Ваш пользователь делает проект у вас, нажимает Deploy — и сайт открывается на Livops. Копировать токен не нужно: пользователь один раз нажимает «Разрешить».
Как это работает
- При первом Deploy вы отправляете пользователя на страницу разрешения Livops.
- Он входит в Livops (или регистрируется), выбирает команду и нажимает Разрешить.
- Livops возвращает его на ваш сайт с
code, вы обмениваете его на токен. - Ваш сервер загружает файлы архивом, создаёт проект и следит за сборкой.
- В следующий раз пользователь просто нажимает Deploy — с сохранённым токеном.
Это стандартный OAuth 2.1 (authorization code + PKCE). Подойдёт любая OAuth-библиотека.
1. Регистрация приложения
В кабинете откройте Аккаунт → Мои приложения и укажите две вещи:
- название приложения — именно оно будет на странице разрешения;
- адрес возврата (
redirect_uri), напримерhttps://app.example/livops/callback— толькоhttps, до 5 адресов.
Нажмите Создать приложение и скопируйте client_id. Client secret нет: защиту дают PKCE и заранее зарегистрированный адрес возврата.
Приложение сразу работает для всех. На странице разрешения рядом с его названием будут ваш email и пометка «название не проверено Livops». За значком Проверенный партнёр напишите команде Livops. При смене названия значок снимается.
2. Подключение пользователя
Для каждого подключения создайте случайный code_verifier (43–128 символов) и вычислите code_challenge:
code_challenge = BASE64URL( SHA256(code_verifier) ) # без =
Отправьте пользователя по адресу:
https://livops.uz/oauth/authorize
?response_type=code
&client_id=<client_id>
&redirect_uri=https://app.example/livops/callback
&scope=deploy
&code_challenge=<code_challenge>
&code_challenge_method=S256
&state=<случайное значение>
После разрешения Livops вернёт:
https://app.example/livops/callback?code=lvc_...&state=<то же значение>&iss=https://livops.uz
Проверьте, что state совпадает с отправленным. Если пользователь отказал — ?error=access_denied.
Обменяйте код на токен в течение 60 секунд (код одноразовый):
curl https://livops.uz/api/mcp/oauth/token \
-d grant_type=authorization_code \
-d code=lvc_... \
-d redirect_uri=https://app.example/livops/callback \
-d client_id=<client_id> \
-d code_verifier=<code_verifier>
{
"access_token": "lvo_...",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "lvr_...",
"scope": "deploy"
}
access_tokenдействует 1 час.- С
refresh_tokenвы получаете новую пару. При каждом обновлении старыйrefresh_tokenсгорает — храните последний. Повторная отправка старого отменяет подключение целиком (токен считается украденным). - Если не пользоваться 30 дней, пользователю нужно подключиться заново.
curl https://livops.uz/api/mcp/oauth/token \
-d grant_type=refresh_token \
-d refresh_token=lvr_... \
-d client_id=<client_id>
Храните токены только на сервере. Не отдавайте их в браузер: в запросе с заголовком Cookie, Origin или Sec-Fetch-* Livops токен не учитывает.
3. Отправка файлов
Упакуйте папку проекта в zip (node_modules, dist, .git не нужны) и загрузите:
curl https://livops.uz/api/uploads/zip \
-H 'Authorization: Bearer lvo_...' \
-F [email protected]
{
"id": "22ac5e77-d7b2-46ef-b7ba-a9b38220c964",
"files": 4,
"bytes": 844,
"kind": "site",
"preset": { "name": "vite", "label": "Vite", "build": "npm run build", "output": "dist" }
}
Livops сам определяет фреймворк (preset). Ограничения: одна загрузка — 200 МБ и 5000 файлов, загрузки, ещё не ставшие проектами, — до 1 ГБ на аккаунт.
4. Создание проекта
curl https://livops.uz/api/projects \
-H 'Authorization: Bearer lvo_...' \
-H 'Content-Type: application/json' \
-d '{
"name": "my-site",
"kind": "site",
"source": "upload",
"sourceRef": "22ac5e77-d7b2-46ef-b7ba-a9b38220c964",
"preset": "vite",
"env": [{ "name": "VITE_API_URL", "value": "https://api.example.com" }]
}'
sourceRef—idиз ответа загрузки.preset—preset.nameиз ответа загрузки. Без него проект создаётся как обычный HTML.envнеобязателен."secret": trueскрывает значение при последующих чтениях.
В ответе приходят проект и первая сборка:
{
"project": { "id": "7088b8bf-…", "slug": "my-site", "preset": "vite", "status": "draft" },
"deploy": { "id": "7d8644bd-…", "status": "queued" }
}
Сохраните project.id рядом с проектом пользователя — следующие деплои идут через него.
5. Статус сборки и адрес
curl https://livops.uz/api/deploys/<deploy.id> \
-H 'Authorization: Bearer lvo_...'
Значения status:
| Статус | Значение |
|---|---|
queued |
В очереди |
building |
Идёт сборка |
live |
Сайт работает |
failed |
Ошибка — причина в полях error и log |
cancelled |
Отменён до начала |
awaiting_payment |
Сборка готова, для запуска нужно пополнить баланс |
Опрашивайте каждые 3–5 секунд. Когда статус live, адрес сайта — в проекте:
curl https://livops.uz/api/projects/<project.id> \
-H 'Authorization: Bearer lvo_...'
# { ..., "host": "my-site.livops.app" }
6. Следующие деплои
Снова загрузите новые файлы архивом и передайте проекту:
curl https://livops.uz/api/projects/<project.id>/deploys \
-H 'Authorization: Bearer lvo_...' \
-H 'Content-Type: application/json' \
-d '{ "upload": "<id новой загрузки>" }'
Запрос без тела (-d '{}') пересобирает те же файлы. Если сборка уже в очереди — 409 deploy_in_progress: дождитесь окончания.
7. Переменные
curl -X PATCH https://livops.uz/api/projects/<project.id>/env \
-H 'Authorization: Bearer lvo_...' \
-H 'Content-Type: application/json' \
-d '{ "name": "VITE_API_URL", "value": "https://api.example.com" }'
Несколько сразу: { "vars": [{ "name": "...", "value": "..." }, ...] }. Новое значение применяется при следующем деплое.
Что может приложение
Пользователь видит именно этот список на странице разрешения.
- Может: загружать файлы, создавать проекты в этой команде, читать созданные им проекты, деплоить их заново, записывать переменные, отменять сборку.
- Не может: видеть другие проекты команды (они отвечают
404), читать переменные, что-либо удалять, трогать домены, базы, оплату и настройки аккаунта.
Чтобы создавать проекты, пользователь должен быть владельцем выбранной команды. Пользователь может отключить приложение в любой момент в Аккаунт → Подключённые AI-приложения — токены сразу перестают работать.
Ошибки
Ответ с ошибкой всегда одной формы, message — на языке пользователя (Accept-Language: uz или ru):
{ "code": "deploy_in_progress", "message": "…", "field": "…" }
| Код | Что делать |
|---|---|
401 |
Токен истёк — обновите через refresh_token. Если и обновление вернуло invalid_grant, подключите пользователя заново |
403 address_unproven |
Пользователь не подтвердил email — покажите сообщение |
403 forbidden |
Действие закрыто для приложения или пользователь не владелец команды |
404 |
Проекта нет или его создало другое приложение |
402 build_needs_credit, 402 daily_builds_used |
Лимит тарифа — отправьте пользователя в кабинет Livops |
409 deploy_in_progress |
Сборка уже идёт |
413 |
Файлы слишком большие |
429 |
Слишком много запросов — подождите и повторите |