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.
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ť:
| Rozsah | Umožňuje |
|---|---|
| Len čítanie | apliká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ístup | nasadzovanie a navyše premenné (čítanie a zmena) a domény (pridanie, odstránenie) |
| Plný prístup a terminál | plný 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 /apps | vaše aplikácie a ich služby | čítanie |
GET /apps/{id} | jedna aplikácia | čítanie |
GET /apps/{id}/deployments | jej nasadenia | čítanie |
POST /apps/{id}/deployments | nasadenie: zostaví posledný commit, alebo s {"rebuild": false} znova nasadí bežiacu verziu | nasadzovanie |
GET /apps/{id}/deployments/{deployment} | nasadenie s logom zostavenia | čítanie |
POST /apps/{id}/deployments/{deployment}/rollback | návrat k tejto verzii | nasadzovanie |
POST /apps/{id}/restart | reštart | nasadzovanie |
GET /apps/{id}/logs | logy behu webu, workera alebo plánovača | čítanie |
GET, PUT, PATCH /apps/{id}/env | čítanie, nahradenie alebo úprava premenných | plný |
GET /apps/{id}/domains | domény | čítanie |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | pridanie alebo odstránenie domény | plný |
- 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
429sRetry-After. - Jazyk: správy prichádzajú predvolene v angličtine; pošlite
Accept-Language: azaleborupre 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 verziiV 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.