Začít

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í.

4 MIN ČTENÍ

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:

RozsahPovoluje
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řístupnasazení a navíc proměnné (čtení a změny) a domény (přidání, odebrání)
Plný přístup a terminálplný 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/apps

Co můžete dělat:

Metoda a cestaCo děláRozsah
GET /appsvaše aplikace a jejich službyčtení
GET /apps/{id}jedna aplikacečtení
GET /apps/{id}/deploymentsjejí nasazeníčtení
POST /apps/{id}/deploymentsnasazení: sestaví poslední commit, nebo s {"rebuild": false} znovu nasadí běžící verzinasazení
GET /apps/{id}/deployments/{deployment}nasazení s logem sestaveníčtení
POST /apps/{id}/deployments/{deployment}/rollbacknávrat k této verzinasazení
POST /apps/{id}/restartrestartnasazení
GET /apps/{id}/logslogy za běhu webu, workeru nebo plánovačečtení
GET, PUT, PATCH /apps/{id}/envčtení, nahrazení nebo úprava proměnnýchplný
GET /apps/{id}/domainsdoményčtení
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}přidání nebo odebrání doményplný
  • 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í 429 s Retry-After.
  • Jazyk: zprávy jsou ve výchozím stavu anglicky; pošlete Accept-Language: az nebo ru pro á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 version

V 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.

Pořád si nevíte rady?

Napište nám do chatu — AI odpoví hned a technik se připojí, když je potřeba, v kteroukoli denní dobu.

Kontaktovat podporu