Alati za developere: API tokeni, REST API, CLI i „Objasni ovu grešku“.
Kreirajte API tokene sa odgovarajućim ovlašćenjima, radite sa aplikacijama iz skripti i CI-ja preko REST API-ja i komandne linije rivervo, i dobijte objašnjenja neuspelih deployeva koja piše AI.
Sve što sa aplikacijama radite u panelu možete raditi i skriptama — deploy iz CI-ja, promenljive iz skripte, logove u terminalu.
API tokeni
Podešavanja naloga → API tokeni → Kreiraj token. Dajte mu ime (gde se koristi, npr. „GitHub Actions“) i izaberite šta sme da radi:
| Ovlašćenje | Dozvoljava |
|---|---|
| Samo čitanje | aplikacije, deployi i njihovi logovi, logovi rada, domeni |
| Čitanje i deploy | čitanje, plus deploy, vraćanje verzije i restart |
| Pun pristup | deploy, plus promenljive (čitanje i izmena) i domeni (dodavanje, uklanjanje) |
| Pun pristup i terminal | pun pristup, plus komande na vašim sajtovima, njihovi fajlovi, cron zadaci, SSH ključevi i deploy iz Git-a |
Možete podesiti i kada ističe — posle 30, 90 ili 365 dana, ili nikada.
- Token se prikazuje samo jednom — kopirajte ga odmah.
- Token radi sa vašim pristupom. U tuđem nalogu radi sa vašom ulogom u aplikaciji, a ovlašćenje tokena se primenjuje povrh toga. Pogledajte Pristup aplikaciji.
- Možete imati do 20 tokena. Opozovi odmah gasi token.
- Svoje tokene možete kreirati samo vi: neko ko je prijavljen na vaš nalog u vaše ime ne može.
REST API
API je dokumentovan u formatu OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Uvezite ga u Postman, Insomnia ili generator koda.
Osnovna adresa: https://api.rivervo.com/api/v1. Šaljite token kao bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsŠta možete da radite:
| Metoda i putanja | Šta radi | Ovlašćenje |
|---|---|---|
GET /apps | vaše aplikacije i njihovi servisi | čitanje |
GET /apps/{id} | jedna aplikacija | čitanje |
GET /apps/{id}/deployments | njeni deployi | čitanje |
POST /apps/{id}/deployments | deploy: build poslednjeg commita ili, sa {"rebuild": false}, ponovna objava verzije koja radi | deploy |
GET /apps/{id}/deployments/{deployment} | deploy sa logom builda | čitanje |
POST /apps/{id}/deployments/{deployment}/rollback | vraćanje na tu verziju | deploy |
POST /apps/{id}/restart | restart | deploy |
GET /apps/{id}/logs | logovi rada sajta, workera ili rasporeda | čitanje |
GET, PUT, PATCH /apps/{id}/env | čitanje, zamena ili ažuriranje promenljivih | pun |
GET /apps/{id}/domains | domeni | čitanje |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | dodavanje ili uklanjanje domena | pun |
- Tuđi nalog: dodajte zaglavlje
X-Account: <ID klijenta tog naloga>da biste radili sa aplikacijama naloga kojem ste dobili pristup. - Ograničenja: 120 zahteva u minutu po osobi, od toga 30 izmena. Preko toga API odgovara sa
429iRetry-After. - Jezik: poruke su podrazumevano na engleskom; pošaljite
Accept-Language: aziliruza azerbejdžanski ili ruski. - Promenljive izmenjene preko API-ja stižu do aplikacije pri sledećem deployu, kao i u panelu —
{"rebuild": false}je dovoljno.
Komandna linija rivervo
Deployi, logovi, promenljive i vraćanje verzija iz vašeg terminala, sa istim API tokenima. Potreban je Node.js 22 ili noviji:
npm install -g rivervo
rivervo login # nalepite token
rivervo deploy shop # build poslednjeg commita i praćenje deploya
rivervo logs shop -f # praćenje izlaza aplikacije
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # nazad na prethodnu verzijuU CI-ju čita token iz promenljive RIVERVO_TOKEN, a deploy se završava greškom kada nova verzija ne postane dostupna, pa može da zaustavi pipeline. Dok ne bude objavljen, isto se može uraditi preko REST API-ja.
„Objasni ovu grešku“
Kada se deploy ne završi ili servis prestane da radi, pored loga se pojavljuje Objasni ovu grešku. Čita poslednje redove loga i na vašem jeziku vam kaže:
- Verovatan uzrok — šta je pošlo naopako;
- Kako da to popravite — konkretne korake za vaš stek.
Objašnjenje na osnovu loga piše AI; proverite ga pre nego što bilo šta promenite. Pre slanja iz loga se sakrivaju sve vrednosti vaših promenljivih i sve što liči na ključ, lozinku ili token. Vaš kod i same promenljive nikada se ne šalju.
Svaka osoba može zatražiti do 10 novih objašnjenja dnevno; objašnjenje koje je već napravljeno za isti log ponovo se prikazuje besplatno.
Rivervo MCP
Sa aplikacijama možete raditi i iz AI asistenata preko Rivervo MCP — radi sa Claude-om, ChatGPT-jem, Cursorom, VS Code-om i drugim aplikacijama koje podržavaju MCP: pitajte o deployima, logovima i greškama u razgovoru i prepustite asistentu da za vas uradi deploy ili vrati verziju. Token nije potreban; prijavljujete se svojim Rivervo nalogom. Pogledajte Rivervo MCP.