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.
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:
| Omfang | Gir tilgang til |
|---|---|
| Bare lesing | applikasjoner, utrullinger og loggene deres, kjørelogger, domener |
| Lesing og utrulling | lesing, pluss utrulling, tilbakerulling og omstart |
| Full tilgang | utrulling, pluss variabler (lese og endre) og domener (legge til, fjerne) |
| Full tilgang og terminal | full 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/appsDette kan du gjøre:
| Metode og sti | Hva den gjør | Omfang |
|---|---|---|
GET /apps | applikasjonene dine og tjenestene deres | lesing |
GET /apps/{id} | én applikasjon | lesing |
GET /apps/{id}/deployments | utrullingene dens | lesing |
POST /apps/{id}/deployments | utrulling: bygg den nyeste commiten, eller med {"rebuild": false} rull ut versjonen som kjører, på nytt | utrulling |
GET /apps/{id}/deployments/{deployment} | en utrulling med byggeloggen | lesing |
POST /apps/{id}/deployments/{deployment}/rollback | gå tilbake til den versjonen | utrulling |
POST /apps/{id}/restart | omstart | utrulling |
GET /apps/{id}/logs | kjørelogger for nettsiden, en worker eller tidsplanen | lesing |
GET, PUT, PATCH /apps/{id}/env | lese, erstatte eller oppdatere variabler | full |
GET /apps/{id}/domains | domener | lesing |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | legge til eller fjerne et domene | full |
- 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
429medRetry-After. - Språk: meldinger kommer på engelsk som standard; send
Accept-Language: azellerrufor 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 versjonI 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.