Kehittäjätyökalut: API-tunnisteet, REST API, CLI ja ”Selitä tämä virhe”.
Luo API-tunnisteita oikeilla oikeuksilla, käsittele sovelluksia skripteistä ja CI:stä REST API:n kautta, käytä rivervo-komentoriviä ja saa AI-selitykset epäonnistuneista julkaisuista.
Kaiken, mitä teet sovelluksille paneelissa, voi myös automatisoida skripteillä — julkaisut CI:stä, muuttujat skriptistä, lokit terminaalissasi.
API-tunnisteet
Tilin asetukset → API-tunnisteet → Luo tunniste. Anna sille nimi (missä sitä käytetään, esim. ”GitHub Actions”) ja valitse, mitä se saa tehdä:
| Oikeus | Sallii |
|---|---|
| Vain luku | sovellukset, julkaisut ja niiden lokit, ajonaikaiset lokit, verkkotunnukset |
| Luku ja julkaisu | luku sekä julkaisu, palautus ja uudelleenkäynnistys |
| Täysi pääsy | julkaisu sekä muuttujat (luku ja muutos) ja verkkotunnukset (lisäys, poisto) |
| Täysi pääsy ja terminaali | täysi pääsy sekä komennot sivustoillasi, niiden tiedostot, cron-tehtävät, SSH-avaimet ja julkaisut Gitistä |
Voit myös asettaa, milloin se vanhenee — 30, 90 tai 365 päivän kuluttua tai ei koskaan.
- Tunniste näytetään kerran — kopioi se heti.
- Tunniste toimii sinun oikeuksillasi. Jonkun toisen tilillä se toimii roolillasi kyseisessä sovelluksessa, ja tunnisteen oikeudet rajaavat sitä lisäksi. Katso Pääsy sovellukseen.
- Sinulla voi olla enintään 20 tunnistetta. Peru pysäyttää tunnisteen heti.
- Vain sinä voit luoda tunnisteesi: joku, joka on kirjautunut tilillesi puolestasi, ei voi.
REST API
API on dokumentoitu OpenAPI 3.1 -muodossa: api.rivervo.com/api/v1/openapi.json. Tuo se Postmaniin, Insomniaan tai koodigeneraattoriin.
Perusosoite: https://api.rivervo.com/api/v1. Lähetä tunniste bearer-tunnisteena:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsMitä voit tehdä:
| Metodi ja polku | Mitä se tekee | Oikeus |
|---|---|---|
GET /apps | sovelluksesi ja niiden palvelut | luku |
GET /apps/{id} | yksi sovellus | luku |
GET /apps/{id}/deployments | sen julkaisut | luku |
POST /apps/{id}/deployments | julkaisu: buildaa uusin commit tai julkaise {"rebuild": false} -arvolla käynnissä oleva versio uudelleen | julkaisu |
GET /apps/{id}/deployments/{deployment} | julkaisu build-lokeineen | luku |
POST /apps/{id}/deployments/{deployment}/rollback | paluu kyseiseen versioon | julkaisu |
POST /apps/{id}/restart | uudelleenkäynnistys | julkaisu |
GET /apps/{id}/logs | sivuston, workerin tai ajastuksen ajonaikaiset lokit | luku |
GET, PUT, PATCH /apps/{id}/env | muuttujien luku, korvaus tai päivitys | täysi |
GET /apps/{id}/domains | verkkotunnukset | luku |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | verkkotunnuksen lisäys tai poisto | täysi |
- Jonkun toisen tili: lisää otsake
X-Account: <tilin asiakastunnus>käsitelläksesi sellaisen tilin sovelluksia, johon sinulle on annettu pääsy. - Rajat: 120 pyyntöä minuutissa henkilöä kohden, joista 30 muutoksia. Niiden yli API vastaa
429jaRetry-After. - Kieli: viestit tulevat oletuksena englanniksi; lähetä
Accept-Language: aztairusaadaksesi ne azerbaidžaniksi tai venäjäksi. - API:n kautta muutetut muuttujat tulevat sovellukseen sen seuraavassa julkaisussa, kuten paneelissakin —
{"rebuild": false}riittää.
rivervo-komentorivi
Julkaisut, lokit, muuttujat ja palautukset terminaalistasi samoilla API-tunnisteilla. Se vaatii Node.js 22:n tai uudemman:
npm install -g rivervo
rivervo login # liitä tunniste
rivervo deploy shop # buildaa uusin commit ja seuraa julkaisua
rivervo logs shop -f # seuraa sovelluksen tulostetta
rivervo env set shop API_URL=https://yritys.fi
rivervo rollback shop # takaisin edelliseen versioonCI:ssä se lukee tunnisteen RIVERVO_TOKEN-muuttujasta, ja deploy päättyy virheeseen, kun uusi versio ei mene tuotantoon, joten se voi toimia putken porttina. Kunnes se on julkaistu, saman voi tehdä REST API:lla.
”Selitä tämä virhe”
Kun julkaisu ei valmistu tai palvelu lakkaa toimimasta, lokin viereen ilmestyy Selitä tämä virhe. Se lukee lokin viimeiset rivit ja kertoo sinulle omalla kielelläsi:
- Todennäköinen syy — mikä meni vikaan;
- Näin korjaat sen — konkreettiset vaiheet teknologiallesi.
AI kirjoittaa selityksen lokin perusteella; tarkista se ennen kuin muutat mitään. Ennen kuin mitään lähetetään, kaikki muuttujiesi arvot ja kaikki avaimelta, salasanalta tai tunnisteelta näyttävä piilotetaan lokista. Koodiasi ja muuttujiasi itsessään ei koskaan lähetetä.
Jokainen voi pyytää enintään 10 uutta selitystä päivässä; samasta lokista jo tehty selitys näytetään uudelleen ilmaiseksi.
Rivervo MCP
Voit käsitellä sovelluksiasi myös AI-avustajista Rivervo MCP:n kautta — se toimii Clauden, ChatGPT:n, Cursorin, VS Coden ja muiden MCP:tä tukevien sovellusten kanssa: kysy julkaisuista, lokeista ja virheistä keskustelussa ja anna avustajan julkaista tai palauttaa puolestasi. Tunnistetta ei tarvita; kirjaudut Rivervo-tililläsi. Katso Rivervo MCP.