Започнете

Инструменти за разработчици: 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внедряване: изграждане на последния 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.

Още имате въпроси?

Пишете ни в чата — AI отговаря веднага, а инженер се включва, когато е нужно, по всяко време на денонощието.

Връзка с поддръжката