Представляем Livops 2.0! ПромокодCEOдарит 8 000 сумов на ваш счёт.Что нового
API и CLI / Деплой из вашего приложения (для партнёров)

API и CLI

Деплой из вашего приложения (для партнёров)

Для платформ, которые создают сайты: пользователь один раз подключает Livops, а кнопка «Deploy» отправляет файлы прямо в Livops.

Эта страница для платформ, которые создают сайты и приложения (AI app builder, конструктор, IDE). Ваш пользователь делает проект у вас, нажимает Deploy — и сайт открывается на Livops. Копировать токен не нужно: пользователь один раз нажимает «Разрешить».

Как это работает

  1. При первом Deploy вы отправляете пользователя на страницу разрешения Livops.
  2. Он входит в Livops (или регистрируется), выбирает команду и нажимает Разрешить.
  3. Livops возвращает его на ваш сайт с code, вы обмениваете его на токен.
  4. Ваш сервер загружает файлы архивом, создаёт проект и следит за сборкой.
  5. В следующий раз пользователь просто нажимает 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 Слишком много запросов — подождите и повторите

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