Инструменти за разработчици: 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 | внедряване: изграждане на последния commit или, с {"rebuild": false}, повторно внедряване на работещата версия | внедряване |
GET /apps/{id}/deployments/{deployment} | внедряване с лога от билда | четене |
POST /apps/{id}/deployments/{deployment}/rollback | връщане към тази версия | внедряване |
POST /apps/{id}/restart | рестартиране | внедряване |
GET /apps/{id}/logs | логове по време на работа на сайта, на worker или на графика | четене |
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 # поставете токена
rivervo deploy shop # изграждане на последния commit и следене на внедряването
rivervo logs shop -f # следене на изхода на приложението
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # връщане към предишната версияВ CI той чете токена от променливата RIVERVO_TOKEN, а deploy завършва с грешка, когато новата версия не излезе на живо, така че може да спира pipeline. Докато не бъде публикуван, същото може да се направи през REST API.
„Обясни тази грешка“
Когато внедряване не завърши или услуга спре да работи, до лога се появява Обясни тази грешка. Тя прочита последните редове от лога и ви казва на вашия език:
- Вероятна причина — какво се е объркало;
- Как да го поправите — конкретни стъпки за вашия стек.
Обяснението се пише от AI въз основа на лога; проверете го, преди да промените каквото и да е. Преди да се изпрати каквото и да е, всяка стойност на променливите ви и всичко, което прилича на ключ, парола или токен, се скрива от лога. Самите ви код и променливи никога не се изпращат.
Всеки човек може да поиска до 10 нови обяснения на ден; обяснение, вече направено за същия лог, се показва отново безплатно.
Rivervo MCP
Можете да работите с приложенията си и от AI асистенти чрез Rivervo MCP — работи с Claude, ChatGPT, Cursor, VS Code и други приложения с поддръжка на MCP: питайте за внедрявания, логове и грешки в разговор и оставете асистента да внедрява или връща назад вместо вас. Не е нужен токен; влизате с акаунта си в Rivervo. Вижте Rivervo MCP.