Započnite

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.

4 MIN ČITANJA

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:

OvlastiDopušta
Samo čitanjeaplikacije, deployji i njihovi zapisi, zapisi izvođenja, domene
Čitanje i deployčitanje, plus deploy, vraćanje verzije i ponovno pokretanje
Potpuni pristupdeploy, plus varijable (čitanje i promjena) i domene (dodavanje, uklanjanje)
Potpuni pristup i terminalpotpuni 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 radiOvlasti
GET /appsvaše aplikacije i njihovi servisičitanje
GET /apps/{id}jedna aplikacijačitanje
GET /apps/{id}/deploymentsnjezini deployjičitanje
POST /apps/{id}/deploymentsdeploy: izgradi zadnji commit ili, uz {"rebuild": false}, ponovno pokreni trenutnu verzijudeploy
GET /apps/{id}/deployments/{deployment}deploy sa zapisom buildačitanje
POST /apps/{id}/deployments/{deployment}/rollbackpovratak na tu verzijudeploy
POST /apps/{id}/restartponovno pokretanjedeploy
GET /apps/{id}/logszapisi izvođenja stranice, workera ili rasporedačitanje
GET, PUT, PATCH /apps/{id}/envčitanje, zamjena ili ažuriranje varijablipotpuni
GET /apps/{id}/domainsdomenečitanje
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}dodavanje ili uklanjanje domenepotpuni
  • 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 429 i Retry-After.
  • Jezik: poruke prema zadanim postavkama stižu na engleskom; pošaljite Accept-Language: az ili ru za 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 verziju

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

Još uvijek zapelo?

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

Kontaktirajte podršku