Aloita

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.

3 MIN LUKUAIKA

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ä:

OikeusSallii
Vain lukusovellukset, julkaisut ja niiden lokit, ajonaikaiset lokit, verkkotunnukset
Luku ja julkaisuluku sekä julkaisu, palautus ja uudelleenkäynnistys
Täysi pääsyjulkaisu sekä muuttujat (luku ja muutos) ja verkkotunnukset (lisäys, poisto)
Täysi pääsy ja terminaalitä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/apps

Mitä voit tehdä:

Metodi ja polkuMitä se tekeeOikeus
GET /appssovelluksesi ja niiden palvelutluku
GET /apps/{id}yksi sovellusluku
GET /apps/{id}/deploymentssen julkaisutluku
POST /apps/{id}/deploymentsjulkaisu: buildaa uusin commit tai julkaise {"rebuild": false} -arvolla käynnissä oleva versio uudelleenjulkaisu
GET /apps/{id}/deployments/{deployment}julkaisu build-lokeineenluku
POST /apps/{id}/deployments/{deployment}/rollbackpaluu kyseiseen versioonjulkaisu
POST /apps/{id}/restartuudelleenkäynnistysjulkaisu
GET /apps/{id}/logssivuston, workerin tai ajastuksen ajonaikaiset lokitluku
GET, PUT, PATCH /apps/{id}/envmuuttujien luku, korvaus tai päivitystäysi
GET /apps/{id}/domainsverkkotunnuksetluku
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}verkkotunnuksen lisäys tai poistotä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 429 ja Retry-After.
  • Kieli: viestit tulevat oletuksena englanniksi; lähetä Accept-Language: az tai ru saadaksesi 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 versioon

CI: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.

Jäikö jotain epäselväksi?

Kirjoita meille chatissa — AI vastaa heti, ja insinööri liittyy mukaan tarvittaessa mihin aikaan tahansa.

Ota yhteyttä tukeen