Započnite

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.

4 MIN ČITANJA

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šćenjeDozvoljava
Samo čitanjeaplikacije, deployi i njihovi logovi, logovi rada, domeni
Čitanje i deployčitanje, plus deploy, vraćanje verzije i restart
Pun pristupdeploy, plus promenljive (čitanje i izmena) i domeni (dodavanje, uklanjanje)
Pun pristup i terminalpun 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 radiOvlašćenje
GET /appsvaše aplikacije i njihovi servisičitanje
GET /apps/{id}jedna aplikacijačitanje
GET /apps/{id}/deploymentsnjeni deployičitanje
POST /apps/{id}/deploymentsdeploy: build poslednjeg commita ili, sa {"rebuild": false}, ponovna objava verzije koja radideploy
GET /apps/{id}/deployments/{deployment}deploy sa logom buildačitanje
POST /apps/{id}/deployments/{deployment}/rollbackvraćanje na tu verzijudeploy
POST /apps/{id}/restartrestartdeploy
GET /apps/{id}/logslogovi rada sajta, workera ili rasporedačitanje
GET, PUT, PATCH /apps/{id}/envčitanje, zamena ili ažuriranje promenljivihpun
GET /apps/{id}/domainsdomeničitanje
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}dodavanje ili uklanjanje domenapun
  • 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 429 i Retry-After.
  • Jezik: poruke su podrazumevano na engleskom; pošaljite Accept-Language: az ili ru za 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 verziju

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

I dalje vam treba pomoć?

Pišite nam u čet — AI odgovara odmah, a inženjer se uključuje kada je potrebno, u bilo koje doba dana.

Kontaktirajte podršku