Začať

Nástroje pre vývojárov: API tokeny, REST API, CLI a „Vysvetliť chybu“.

Vytvárajte API tokeny so správnym rozsahom, pracujte s aplikáciami zo skriptov a CI cez REST API a príkazový riadok rivervo a nechajte AI vysvetliť neúspešné nasadenia.

4 MIN. ČÍTANIA

Všetko, čo s aplikáciami robíte v paneli, sa dá aj skriptovať — nasadenia z CI, premenné zo skriptu, logy vo vašom termináli.

API tokeny

Nastavenia účtu → API tokeny → Vytvoriť token. Pomenujte ho (kde sa používa, napr. „GitHub Actions“) a zvoľte, čo môže robiť:

RozsahUmožňuje
Len čítanieaplikácie, nasadenia a ich logy, logy behu, domény
Čítanie a nasadzovaniečítanie a navyše nasadenie, návrat k verzii a reštart
Plný prístupnasadzovanie a navyše premenné (čítanie a zmena) a domény (pridanie, odstránenie)
Plný prístup a terminálplný prístup a navyše príkazy na vašich weboch, ich súbory, úlohy cron, SSH kľúče a nasadenia z Gitu

Môžete nastaviť aj platnosť — 30, 90 alebo 365 dní, alebo bez obmedzenia.

  • Token sa zobrazí raz — hneď ho skopírujte.
  • Token koná s vaším prístupom. V cudzom účte koná s vašou rolou v aplikácii a navyše platí rozsah tokenu. Pozrite si Prístup k aplikácii.
  • Môžete mať najviac 20 tokenov. Zrušiť token okamžite zneplatní.
  • Svoje tokeny môžete vytvárať len vy: niekto prihlásený do vášho účtu vo vašom mene to nedokáže.

REST API

API je zdokumentované v OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importujte ho do Postmanu, Insomnie alebo generátora kódu.

Základná adresa: https://api.rivervo.com/api/v1. Token posielajte ako bearer token:

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

Čo môžete robiť:

Metóda a cestaČo robíRozsah
GET /appsvaše aplikácie a ich službyčítanie
GET /apps/{id}jedna aplikáciačítanie
GET /apps/{id}/deploymentsjej nasadeniačítanie
POST /apps/{id}/deploymentsnasadenie: zostaví posledný commit, alebo s {"rebuild": false} znova nasadí bežiacu verziunasadzovanie
GET /apps/{id}/deployments/{deployment}nasadenie s logom zostaveniačítanie
POST /apps/{id}/deployments/{deployment}/rollbacknávrat k tejto verziinasadzovanie
POST /apps/{id}/restartreštartnasadzovanie
GET /apps/{id}/logslogy behu webu, workera alebo plánovačačítanie
GET, PUT, PATCH /apps/{id}/envčítanie, nahradenie alebo úprava premennýchplný
GET /apps/{id}/domainsdoményčítanie
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}pridanie alebo odstránenie doményplný
  • Cudzí účet: pridajte hlavičku X-Account: <the account's customer ID>, ak chcete pracovať s aplikáciami účtu, ku ktorému vám bol udelený prístup.
  • Limity: 120 požiadaviek za minútu na osobu, z toho 30 zmien. Po ich prekročení API odpovie 429 s Retry-After.
  • Jazyk: správy prichádzajú predvolene v angličtine; pošlite Accept-Language: az alebo ru pre azerbajdžanské alebo ruské správy.
  • Premenné zmenené cez API sa do aplikácie dostanú pri ďalšom nasadení, rovnako ako v paneli — stačí {"rebuild": false}.

Príkazový riadok rivervo

Nasadenia, logy, premenné a návrat k verzii z vášho terminálu, s tými istými API tokenmi. Vyžaduje Node.js 22 alebo novší:

npm install -g rivervo
rivervo login                       # vložte token
rivervo deploy shop                 # zostaví posledný commit a sleduje nasadenie
rivervo logs shop -f                # sleduje výstup aplikácie
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # návrat k predchádzajúcej verzii

V CI číta token z premennej RIVERVO_TOKEN a deploy skončí s chybou, keď sa nová verzia nedostane do prevádzky, takže môže podmieňovať pipeline. Kým nie je zverejnený, to isté sa dá urobiť cez REST API.

„Vysvetliť chybu“

Keď sa nasadenie nedokončí alebo služba prestane fungovať, vedľa logu sa zobrazí Vysvetliť chybu. Prečíta posledné riadky logu a vo vašom jazyku vám povie:

  • Pravdepodobná príčina — čo sa pokazilo;
  • Ako to opraviť — konkrétne kroky pre váš stack.

Vysvetlenie píše AI na základe logu; pred akoukoľvek zmenou si ho overte. Pred odoslaním sa z logu skryjú všetky hodnoty vašich premenných a všetko, čo vyzerá ako kľúč, heslo alebo token. Váš kód ani samotné premenné sa nikdy neodosielajú.

Každý môže požiadať najviac o 10 nových vysvetlení denne; vysvetlenie, ktoré už pre rovnaký log existuje, sa zobrazí znova zadarmo.

Rivervo MCP

S aplikáciami môžete pracovať aj z AI asistentov cez Rivervo MCP — funguje s Claude, ChatGPT, Cursor, VS Code a ďalšími aplikáciami, ktoré podporujú MCP: pýtajte sa na nasadenia, logy a chyby v konverzácii a nechajte asistenta nasadiť alebo vrátiť verziu za vás. Token netreba; prihlásite sa svojím účtom Rivervo. Pozrite si Rivervo MCP.

Stále si neviete rady?

Napíšte nám do chatu — AI odpovie okamžite a technik sa pripojí, keď treba, v ktorúkoľvek dennú hodinu.

Kontaktovať podporu