Alati za developere: API tokeni, REST API, CLI i «Objasni ovu pogrešku».
Izradite API tokene s odgovarajućim ovlastima, radite s aplikacijama iz skripti i CI-ja putem REST API-ja i naredbenog retka rivervo te dobijte objašnjenja neuspjelih deployja koja piše AI.
Sve što s aplikacijama radite u panelu možete raditi i skriptama — deployje iz CI-ja, varijable iz skripte, zapise u svom terminalu.
API tokeni
Postavke računa → API tokeni → Izradi token. Dajte mu naziv (gdje se koristi, npr. «GitHub Actions») i odaberite što smije raditi:
| Ovlasti | Dopušta |
|---|---|
| Samo čitanje | aplikacije, deployji i njihovi zapisi, zapisi izvođenja, domene |
| Čitanje i deploy | čitanje, plus deploy, vraćanje verzije i ponovno pokretanje |
| Potpuni pristup | deploy, plus varijable (čitanje i promjena) i domene (dodavanje, uklanjanje) |
| Potpuni pristup i terminal | potpuni pristup, plus naredbe na vašim web stranicama, njihove datoteke, cron zadaci, SSH ključevi i deployji iz Gita |
Možete postaviti i kada token istječe — nakon 30, 90 ili 365 dana, ili nikada.
- Token se prikazuje samo jednom — odmah ga kopirajte.
- Token djeluje s vašim pristupom. U tuđem računu djeluje s vašom ulogom u aplikaciji, a ovlasti tokena primjenjuju se povrh toga. Pogledajte Pristup aplikaciji.
- Možete imati najviše 20 tokena. Opozovi odmah gasi token.
- Svoje tokene možete izraditi samo vi: netko tko je u vaš račun prijavljen u vaše ime to ne može.
REST API
API je dokumentiran u formatu OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Uvezite ga u Postman, Insomniju ili generator koda.
Osnovna adresa: https://api.rivervo.com/api/v1. Token šaljite kao bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsŠto možete raditi:
| Metoda i putanja | Što radi | Ovlasti |
|---|---|---|
GET /apps | vaše aplikacije i njihovi servisi | čitanje |
GET /apps/{id} | jedna aplikacija | čitanje |
GET /apps/{id}/deployments | njezini deployji | čitanje |
POST /apps/{id}/deployments | deploy: izgradi zadnji commit ili, uz {"rebuild": false}, ponovno pokreni trenutnu verziju | deploy |
GET /apps/{id}/deployments/{deployment} | deploy sa zapisom builda | čitanje |
POST /apps/{id}/deployments/{deployment}/rollback | povratak na tu verziju | deploy |
POST /apps/{id}/restart | ponovno pokretanje | deploy |
GET /apps/{id}/logs | zapisi izvođenja stranice, workera ili rasporeda | čitanje |
GET, PUT, PATCH /apps/{id}/env | čitanje, zamjena ili ažuriranje varijabli | potpuni |
GET /apps/{id}/domains | domene | čitanje |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | dodavanje ili uklanjanje domene | potpuni |
- Tuđi račun: dodajte zaglavlje
X-Account: <the account's customer ID>da biste radili s aplikacijama računa kojem ste dobili pristup. - Ograničenja: 120 zahtjeva u minuti po osobi, od toga 30 promjena. Iznad toga API odgovara s
429iRetry-After. - Jezik: poruke prema zadanim postavkama stižu na engleskom; pošaljite
Accept-Language: aziliruza azerbajdžanski ili ruski. - Varijable promijenjene putem API-ja stižu do aplikacije pri sljedećem deployu, kao i u panelu — dovoljno je
{"rebuild": false}.
Naredbeni redak rivervo
Deployji, zapisi, varijable i vraćanje verzija iz vašeg terminala, s istim API tokenima. Potreban je Node.js 22 ili noviji:
npm install -g rivervo
rivervo login # zalijepite token
rivervo deploy shop # izgradi zadnji commit i prati deploy
rivervo logs shop -f # prati izlaz aplikacije
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # povratak na prethodnu verzijuU CI-ju čita token iz varijable RIVERVO_TOKEN, a deploy završava s pogreškom kad nova verzija ne postane dostupna, pa može zaustaviti pipeline. Dok ne bude objavljen, isto se može učiniti putem REST API-ja.
«Objasni ovu pogrešku»
Kad se deploy ne završi ili servis prestane raditi, pokraj zapisa pojavljuje se Objasni ovu pogrešku. Funkcija čita zadnje retke zapisa i na vašem jeziku navodi:
- Vjerojatan uzrok — što je pošlo po zlu;
- Kako to popraviti — konkretne korake za vaš stack.
Objašnjenje na temelju zapisa piše AI; provjerite ga prije nego što išta promijenite. Prije slanja iz zapisa se skrivaju sve vrijednosti vaših varijabli i sve što izgleda kao ključ, lozinka ili token. Vaš kod i same varijable nikad se ne šalju.
Svaka osoba može zatražiti najviše 10 novih objašnjenja dnevno; objašnjenje koje je već izrađeno za isti zapis ponovno se prikazuje besplatno.
Rivervo MCP
S aplikacijama možete raditi i iz AI asistenata putem Rivervo MCP-a — radi s Claudeom, ChatGPT-om, Cursorom, VS Codeom i drugim aplikacijama koje podržavaju MCP: pitajte o deployjima, zapisima i pogreškama u razgovoru i prepustite asistentu deploy ili vraćanje verzije. Token nije potreban; prijavljujete se svojim Rivervo računom. Pogledajte Rivervo MCP.