Nástroje pro vývojáře: API tokeny, REST API, CLI a „Vysvětlit chybu“.
Vytvářejte API tokeny se správným rozsahem oprávnění, pracujte s aplikacemi ze skriptů a CI přes REST API a příkazovou řádku rivervo a nechte si od AI vysvětlit nepovedená nasazení.
Vše, co s aplikacemi děláte v panelu, jde také skriptovat — nasazení z CI, proměnné ze skriptu, logy v terminálu.
API tokeny
Nastavení účtu → API tokeny → Vytvořit token. Pojmenujte ho (podle toho, kde se používá, např. „GitHub Actions“) a zvolte, co smí dělat:
| Rozsah | Povoluje |
|---|---|
| Pouze čtení | aplikace, nasazení a jejich logy, logy za běhu, domény |
| Čtení a nasazení | čtení a navíc nasazení, návrat k verzi a restart |
| Plný přístup | nasazení a navíc proměnné (čtení a změny) a domény (přidání, odebrání) |
| Plný přístup a terminál | plný přístup a navíc příkazy na vašich webech, jejich soubory, úlohy cron, SSH klíče a nasazení z Gitu |
Můžete také nastavit, kdy platnost vyprší — po 30, 90 nebo 365 dnech, nebo nikdy.
- Token se zobrazí jen jednou — hned si ho zkopírujte.
- Token jedná s vaším přístupem. V cizím účtu jedná s vaší rolí v aplikaci a navíc platí rozsah tokenu. Viz Přístup k aplikaci.
- Mít můžete nejvýše 20 tokenů. Zneplatnit token okamžitě vypne.
- Tokeny si můžete vytvořit jen vy sami: kdo je do vašeho účtu přihlášen vaším jménem, to nemůže.
REST API
API je popsané v OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Naimportujte ho do Postmanu, Insomnie nebo generátoru kódu.
Základní adresa: https://api.rivervo.com/api/v1. Token posílejte jako bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsCo můžete dělat:
| Metoda a cesta | Co dělá | Rozsah |
|---|---|---|
GET /apps | vaše aplikace a jejich služby | čtení |
GET /apps/{id} | jedna aplikace | čtení |
GET /apps/{id}/deployments | její nasazení | čtení |
POST /apps/{id}/deployments | nasazení: sestaví poslední commit, nebo s {"rebuild": false} znovu nasadí běžící verzi | nasazení |
GET /apps/{id}/deployments/{deployment} | nasazení s logem sestavení | čtení |
POST /apps/{id}/deployments/{deployment}/rollback | návrat k této verzi | nasazení |
POST /apps/{id}/restart | restart | nasazení |
GET /apps/{id}/logs | logy za běhu webu, workeru nebo plánovače | čtení |
GET, PUT, PATCH /apps/{id}/env | čtení, nahrazení nebo úprava proměnných | plný |
GET /apps/{id}/domains | domény | čtení |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | přidání nebo odebrání domény | plný |
- Cizí účet: přidejte hlavičku
X-Account: <the account's customer ID>a budete pracovat s aplikacemi účtu, ke kterému jste dostali přístup. - Limity: 120 požadavků za minutu na osobu, z toho 30 změn. Při jejich překročení API odpoví
429sRetry-After. - Jazyk: zprávy jsou ve výchozím stavu anglicky; pošlete
Accept-Language: azneborupro ázerbájdžánštinu nebo ruštinu. - Proměnné změněné přes API se do aplikace dostanou s jejím dalším nasazením, stejně jako v panelu — stačí
{"rebuild": false}.
Příkazová řádka rivervo
Nasazení, logy, proměnné a návraty k verzi z terminálu, se stejnými API tokeny. Vyžaduje Node.js 22 nebo novější:
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 versionV CI načte token z proměnné RIVERVO_TOKEN a deploy skončí chybou, když se nová verze nedostane do provozu, takže může hlídat pipeline. Dokud není zveřejněná, totéž zvládnete přes REST API.
„Vysvětlit chybu“
Když se nasazení nedokončí nebo služba přestane fungovat, objeví se vedle logu Vysvětlit chybu. Přečte poslední řádky logu a ve vašem jazyce vám řekne:
- Pravděpodobná příčina — co se pokazilo;
- Jak to opravit — konkrétní kroky pro váš stack.
Vysvětlení píše AI na základě logu; než cokoli změníte, ověřte si ho. Před odesláním se z logu skryjí všechny hodnoty vašich proměnných a vše, co vypadá jako klíč, heslo nebo token. Váš kód ani samotné proměnné se nikdy neodesílají.
Každý může požádat až o 10 nových vysvětlení denně; vysvětlení, které už pro stejný log vzniklo, se zobrazí znovu zdarma.
Rivervo MCP
S aplikacemi můžete pracovat i z AI asistentů přes Rivervo MCP — funguje s Claude, ChatGPT, Cursorem, VS Code a dalšími aplikacemi, které podporují MCP: ptejte se v konverzaci na nasazení, logy a chyby a nechte asistenta nasadit nebo vrátit verzi za vás. Token není potřeba; přihlásíte se svým účtem Rivervo. Viz Rivervo MCP.