Почати

Інструменти розробника: API-токени, REST API, CLI і «Пояснити помилку».

Створюйте API-токени з потрібними правами, працюйте із застосунками зі скриптів і CI через REST API та командний рядок rivervo, отримуйте пояснення невдалих розгортань від AI.

4 ХВ ЧИТАННЯ

Усе, що ви робите із застосунками в панелі, можна автоматизувати: розгортання з CI, змінні зі скрипта, журнали у вашому терміналі.

API-токени

Налаштування акаунта → API-токени → Створити токен. Дайте йому назву (де він використовується, наприклад «GitHub Actions») і виберіть, що йому дозволено:

ПраваЩо дозволяють
Лише читаннязастосунки, розгортання та їхні журнали, журнали роботи, домени
Читання й розгортаннячитання, а також розгортання, відкат і перезапуск
Повний доступрозгортання, а також змінні (читання й зміна) і домени (додавання, видалення)
Повний доступ і терміналповний доступ, а також команди на ваших сайтах, їхні файли, завдання cron, SSH-ключі та розгортання з Git

Можна також задати строк дії — 30, 90 чи 365 днів або безстроково.

  • Токен показується один раз — скопіюйте його одразу.
  • Токен діє з вашим доступом. В акаунті іншої людини він діє з вашою роллю в застосунку, а права токена накладаються зверху. Докладніше — у статті Доступ до застосунку.
  • Можна мати до 20 токенів. Відкликати одразу деактивує токен.
  • Створювати ваші токени можете лише ви: людина, яка увійшла у ваш акаунт від вашого імені, цього зробити не може.

REST API

API описано у форматі OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Імпортуйте його в Postman, Insomnia або генератор коду.

Базова адреса: https://api.rivervo.com/api/v1. Передавайте токен як bearer-токен:

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

Що можна робити:

Метод і шляхЩо робитьПрава
GET /appsваші застосунки та їхні сервісичитання
GET /apps/{id}один застосунокчитання
GET /apps/{id}/deploymentsйого розгортаннячитання
POST /apps/{id}/deploymentsрозгортання: зібрати останній коміт або з {"rebuild": false} розгорнути поточну версію ще разрозгортання
GET /apps/{id}/deployments/{deployment}розгортання із журналом збираннячитання
POST /apps/{id}/deployments/{deployment}/rollbackповернутися до цієї версіїрозгортання
POST /apps/{id}/restartперезапускрозгортання
GET /apps/{id}/logsжурнали роботи сайту, воркера або розкладучитання
GET, PUT, PATCH /apps/{id}/envпрочитати, замінити або оновити змінніповний
GET /apps/{id}/domainsдоменичитання
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}додати або видалити доменповний
  • Акаунт іншої людини: додайте заголовок X-Account: <the account's customer ID>, щоб працювати із застосунками акаунта, до якого вам надали доступ.
  • Ліміти: 120 запитів на хвилину на людину, з них 30 змін. Понад це API відповідає 429 із заголовком Retry-After.
  • Мова: повідомлення за замовчуванням надходять англійською; надішліть Accept-Language: az або ru, щоб отримувати їх азербайджанською чи російською.
  • Змінні, змінені через API, потрапляють у застосунок із наступним розгортанням, як і в панелі, — достатньо {"rebuild": false}.

Командний рядок rivervo

Розгортання, журнали, змінні й відкати з вашого термінала з тими самими API-токенами. Потрібен Node.js 22 або новіший:

npm install -g rivervo
rivervo login                       # paste the token
rivervo deploy shop                 # build the latest commit and follow the deploy
rivervo logs shop -f                # follow the application's output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # back to the previous version

У CI він читає токен зі змінної RIVERVO_TOKEN, а deploy завершується з помилкою, якщо нова версія не запрацювала, тож команду можна використовувати як перевірку в пайплайні. Поки CLI не опубліковано, те саме можна зробити через REST API.

«Пояснити помилку»

Коли розгортання не завершується або сервіс перестає працювати, біля журналу з’являється кнопка Пояснити помилку. Вона читає останні рядки журналу й пояснює вашою мовою:

  • Імовірна причина — що пішло не так;
  • Як виправити — конкретні кроки для вашого стеку.

Пояснення пише AI на основі журналу; перевірте його, перш ніж щось змінювати. Перед надсиланням із журналу приховуються всі значення ваших змінних і все, що схоже на ключ, пароль чи токен. Ваш код і самі змінні не надсилаються ніколи.

Кожна людина може запросити до 10 нових пояснень на день; пояснення, уже створене для того самого журналу, показується знову безкоштовно.

Rivervo MCP

Із застосунками можна працювати й з AI-асистентів через Rivervo MCP — він працює з Claude, ChatGPT, Cursor, VS Code та іншими застосунками, що підтримують MCP: запитуйте про розгортання, журнали й помилки в розмові, а асистент розгорне чи відкотить версію за вас. Токен не потрібен — ви входите через свій акаунт Rivervo. Докладніше — у статті Rivervo MCP.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку