Kom i gang

Utviklerverktøy: API-tokener, REST-API-et, CLI-en og «Forklar denne feilen».

Opprett API-tokener med riktig omfang, jobb med applikasjoner fra skript og CI via REST-API-et og kommandolinjen rivervo, og få forklaringer fra AI på mislykkede utrullinger.

4 MIN LESING

Alt du gjør med applikasjoner i panelet, kan også skriptes — utrullinger fra CI, variabler fra et skript, logger i terminalen din.

API-tokener

Kontoinnstillinger → API-tokener → Opprett et token. Gi det et navn (hvor det brukes, f.eks. «GitHub Actions») og velg hva det får gjøre:

OmfangGir tilgang til
Bare lesingapplikasjoner, utrullinger og loggene deres, kjørelogger, domener
Lesing og utrullinglesing, pluss utrulling, tilbakerulling og omstart
Full tilgangutrulling, pluss variabler (lese og endre) og domener (legge til, fjerne)
Full tilgang og terminalfull tilgang, pluss kommandoer på nettsidene dine, filene deres, cron-jobber, SSH-nøkler og utrullinger fra Git

Du kan også angi når det utløper — etter 30, 90 eller 365 dager, eller aldri.

  • Tokenet vises én gang — kopier det med en gang.
  • Et token handler med din tilgang. I en annens konto handler det med rollen din i applikasjonen, og tokenets omfang gjelder i tillegg. Se Tilgang til en applikasjon.
  • Du kan ha opptil 20 tokener. Tilbakekall stopper et token med en gang.
  • Bare du kan opprette tokenene dine: noen som er logget inn på kontoen din på dine vegne, kan ikke det.

REST-API-et

API-et er dokumentert i OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importer det i Postman, Insomnia eller en kodegenerator.

Basisadresse: https://api.rivervo.com/api/v1. Send tokenet som et bearer-token:

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

Dette kan du gjøre:

Metode og stiHva den gjørOmfang
GET /appsapplikasjonene dine og tjenestene dereslesing
GET /apps/{id}én applikasjonlesing
GET /apps/{id}/deploymentsutrullingene denslesing
POST /apps/{id}/deploymentsutrulling: bygg den nyeste commiten, eller med {"rebuild": false} rull ut versjonen som kjører, på nyttutrulling
GET /apps/{id}/deployments/{deployment}en utrulling med byggeloggenlesing
POST /apps/{id}/deployments/{deployment}/rollbackgå tilbake til den versjonenutrulling
POST /apps/{id}/restartomstartutrulling
GET /apps/{id}/logskjørelogger for nettsiden, en worker eller tidsplanenlesing
GET, PUT, PATCH /apps/{id}/envlese, erstatte eller oppdatere variablerfull
GET /apps/{id}/domainsdomenerlesing
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}legge til eller fjerne et domenefull
  • En annens konto: legg til headeren X-Account: <kontoens kunde-ID> for å jobbe med applikasjonene i en konto du har fått tilgang til.
  • Grenser: 120 forespørsler i minuttet per person, hvorav 30 endringer. Over dette svarer API-et 429 med Retry-After.
  • Språk: meldinger kommer på engelsk som standard; send Accept-Language: az eller ru for aserbajdsjansk eller russisk.
  • Variabler som endres via API-et, når applikasjonen ved neste utrulling, akkurat som i panelet — {"rebuild": false} er nok.

Kommandolinjen rivervo

Utrullinger, logger, variabler og tilbakerullinger fra terminalen, med de samme API-tokenene. Den krever Node.js 22 eller nyere:

npm install -g rivervo
rivervo login                       # lim inn tokenet
rivervo deploy shop                 # bygg den nyeste commiten og følg utrullingen
rivervo logs shop -f                # følg utdataene fra applikasjonen
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # tilbake til forrige versjon

I CI leser den tokenet fra variabelen RIVERVO_TOKEN, og deploy avslutter med en feil når den nye versjonen ikke går live, så den kan stoppe en pipeline. Inntil den er publisert, kan du gjøre det samme med REST-API-et.

«Forklar denne feilen»

Når en utrulling ikke fullføres, eller en tjeneste slutter å fungere, vises Forklar denne feilen ved siden av loggen. Den leser de siste linjene i loggen og forteller deg, på ditt språk:

  • Sannsynlig årsak — hva som gikk galt;
  • Slik løser du det — konkrete steg for din stack.

Forklaringen skrives av AI ut fra loggen; sjekk den før du endrer noe. Før noe sendes, skjules alle verdiene til variablene dine og alt som ser ut som en nøkkel, et passord eller et token, i loggen. Selve koden din og variablene dine sendes aldri.

Hver person kan be om opptil 10 nye forklaringer om dagen; en forklaring som allerede er laget for samme logg, vises igjen gratis.

Rivervo MCP

Du kan også jobbe med applikasjonene dine fra AI-assistenter via Rivervo MCP — det fungerer med Claude, ChatGPT, Cursor, VS Code og andre apper som støtter MCP: spør om utrullinger, logger og feil i en samtale, og la assistenten rulle ut eller rulle tilbake for deg. Du trenger ikke noe token; du logger inn med Rivervo-kontoen din. Se Rivervo MCP.

Står du fast?

Chat med oss – AI svarer med en gang, og en tekniker kommer inn når det trengs, når som helst på døgnet.

Kontakt kundestøtte