Інструменти розробника: API-токени, REST API, CLI і «Пояснити помилку».
Створюйте API-токени з потрібними правами, працюйте із застосунками зі скриптів і CI через REST API та командний рядок rivervo, отримуйте пояснення невдалих розгортань від AI.
Усе, що ви робите із застосунками в панелі, можна автоматизувати: розгортання з 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.