Narzędzia dla programistów: tokeny API, REST API, CLI i „Wyjaśnij ten błąd”.
Twórz tokeny API o odpowiednim zakresie, zarządzaj aplikacjami ze skryptów i CI przez REST API i wiersz poleceń rivervo oraz korzystaj z wyjaśnień nieudanych wdrożeń przygotowanych przez AI.
Wszystko, co robisz z aplikacjami w panelu, możesz też zautomatyzować — wdrożenia z CI, zmienne ze skryptu, logi w terminalu.
Tokeny API
Ustawienia konta → Tokeny API → Utwórz token. Nadaj mu nazwę (gdzie będzie używany, np. „GitHub Actions”) i wybierz, co może robić:
| Zakres | Pozwala na |
|---|---|
| Tylko odczyt | aplikacje, wdrożenia i ich logi, logi działania, domeny |
| Odczyt i wdrażanie | odczyt oraz wdrażanie, wycofywanie i restart |
| Pełny dostęp | wdrażanie oraz zmienne (odczyt i zmiana) i domeny (dodawanie, usuwanie) |
| Pełny dostęp i terminal | pełny dostęp oraz polecenia na twoich stronach, ich pliki, zadania cron, klucze SSH i wdrożenia z Git |
Możesz też ustawić, kiedy token wygaśnie — po 30, 90 lub 365 dniach albo nigdy.
- Token jest pokazywany tylko raz — od razu go skopiuj.
- Token działa z twoimi uprawnieniami. Na cudzym koncie działa z twoją rolą w aplikacji, a dodatkowo obowiązuje zakres tokena. Zobacz Dostęp do aplikacji.
- Możesz mieć do 20 tokenów. Unieważnij od razu wyłącza token.
- Tokeny możesz tworzyć tylko ty: osoba zalogowana na twoje konto w twoim imieniu nie może tego zrobić.
REST API
API jest opisane w OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Zaimportuj je do Postmana, Insomnii albo generatora kodu.
Adres bazowy: https://api.rivervo.com/api/v1. Wysyłaj token jako bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsCo możesz zrobić:
| Metoda i ścieżka | Co robi | Zakres |
|---|---|---|
GET /apps | twoje aplikacje i ich usługi | odczyt |
GET /apps/{id} | jedna aplikacja | odczyt |
GET /apps/{id}/deployments | jej wdrożenia | odczyt |
POST /apps/{id}/deployments | wdrożenie: buduje najnowszy commit, a z {"rebuild": false} ponownie wdraża działającą wersję | wdrażanie |
GET /apps/{id}/deployments/{deployment} | wdrożenie z logiem budowania | odczyt |
POST /apps/{id}/deployments/{deployment}/rollback | powrót do tej wersji | wdrażanie |
POST /apps/{id}/restart | restart | wdrażanie |
GET /apps/{id}/logs | logi działania strony, workera lub harmonogramu | odczyt |
GET, PUT, PATCH /apps/{id}/env | odczyt, zastąpienie lub aktualizacja zmiennych | pełny |
GET /apps/{id}/domains | domeny | odczyt |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | dodanie lub usunięcie domeny | pełny |
- Cudze konto: dodaj nagłówek
X-Account: <the account's customer ID>(ID klienta tego konta), żeby pracować z aplikacjami konta, do którego masz dostęp. - Limity: 120 żądań na minutę na osobę, w tym 30 zmian. Po ich przekroczeniu API odpowiada
429zRetry-After. - Język: komunikaty domyślnie są po angielsku; wyślij
Accept-Language: azlubru, żeby dostać je po azersku lub po rosyjsku. - Zmienne zmienione przez API trafiają do aplikacji przy najbliższym wdrożeniu, tak jak w panelu — wystarczy
{"rebuild": false}.
Wiersz poleceń rivervo
Wdrożenia, logi, zmienne i wycofywanie zmian z terminala, z tymi samymi tokenami API. Wymaga Node.js 22 lub nowszego:
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 versionW CI narzędzie odczytuje token ze zmiennej RIVERVO_TOKEN, a deploy kończy się błędem, gdy nowa wersja nie wejdzie na produkcję, więc może blokować dalsze kroki pipeline'u. Dopóki CLI nie zostanie opublikowane, to samo zrobisz przez REST API.
„Wyjaśnij ten błąd”
Gdy wdrożenie się nie zakończy albo usługa przestanie działać, obok logu pojawia się Wyjaśnij ten błąd. Funkcja czyta ostatnie linie logu i w twoim języku podaje:
- Prawdopodobna przyczyna — co poszło nie tak;
- Jak to naprawić — konkretne kroki dla twojego stosu technologicznego.
Wyjaśnienie pisze AI na podstawie logu; sprawdź je, zanim cokolwiek zmienisz. Zanim cokolwiek zostanie wysłane, z logu ukrywamy wszystkie wartości twoich zmiennych i wszystko, co wygląda na klucz, hasło lub token. Twój kod i same zmienne nigdy nie są wysyłane.
Każda osoba może poprosić o maksymalnie 10 nowych wyjaśnień dziennie; wyjaśnienie przygotowane już dla tego samego logu jest pokazywane ponownie bezpłatnie.
Rivervo MCP
Z aplikacjami możesz też pracować z poziomu asystentów AI przez Rivervo MCP — działa z Claude, ChatGPT, Cursorem, VS Code i innymi aplikacjami obsługującymi MCP: pytaj w rozmowie o wdrożenia, logi i błędy, a asystent może za ciebie wdrożyć lub wycofać zmiany. Token nie jest potrzebny; logujesz się kontem Rivervo. Zobacz Rivervo MCP.