Kom i gang

Udviklerværktøjer: API-tokens, REST API, CLI og «Forklar denne fejl».

Opret API-tokens med det rette omfang, arbejd med applikationer fra scripts og CI via REST API'et og kommandolinjen rivervo, og få forklaringer på fejlslagne deploys skrevet med AI.

4 MIN. LÆSNING

Alt, hvad du gør med applikationer i panelet, kan også scriptes — deploys fra CI, variabler fra et script, logs i din terminal.

API-tokens

Kontoindstillinger → API-tokens → Opret et token. Giv det et navn (hvor det bruges, f.eks. «GitHub Actions»), og vælg, hvad det må:

OmfangTillader
Kun læsningapplikationer, deploys og deres logs, kørselslogs, domæner
Læsning og deploylæsning plus deploy, tilbagerulning og genstart
Fuld adgangdeploy plus variabler (læse og ændre) og domæner (tilføje, fjerne)
Fuld adgang og terminalfuld adgang plus kommandoer på dine hjemmesider, deres filer, cronjobs, SSH-nøgler og deploys fra Git

Du kan også angive, hvornår det udløber — efter 30, 90 eller 365 dage eller aldrig.

  • Tokenet vises én gang — kopiér det med det samme.
  • Et token handler med din adgang. I en andens konto handler det med din rolle i applikationen, og tokenets omfang gælder oven i den. Se Adgang til en applikation.
  • Du kan have op til 20 tokens. Tilbagekald stopper et token med det samme.
  • Kun du kan oprette dine tokens: en person, der er logget ind på din konto på dine vegne, kan ikke.

REST API'et

API'et er dokumenteret i OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importér 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

Det kan du:

Metode og stiHvad den gørOmfang
GET /appsdine applikationer og deres tjenesterlæsning
GET /apps/{id}én applikationlæsning
GET /apps/{id}/deploymentsdens deployslæsning
POST /apps/{id}/deploymentsdeploy: byg det seneste commit, eller deploy den kørende version igen med {"rebuild": false}deploy
GET /apps/{id}/deployments/{deployment}et deploy med build-loglæsning
POST /apps/{id}/deployments/{deployment}/rollbackgå tilbage til den versiondeploy
POST /apps/{id}/restartgenstartdeploy
GET /apps/{id}/logskørselslogs for siden, en worker eller planenlæsning
GET, PUT, PATCH /apps/{id}/envlæs, erstat eller opdater variablerfuld
GET /apps/{id}/domainsdomænerlæsning
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}tilføj eller fjern et domænefuld
  • En andens konto: tilføj headeren X-Account: <kontoens kunde-id> for at arbejde med applikationerne i en konto, du har fået adgang til.
  • Grænser: 120 forespørgsler i minuttet pr. person, heraf 30 ændringer. Derover svarer API'et 429 med Retry-After.
  • Sprog: beskeder kommer som standard på engelsk; send Accept-Language: az eller ru for aserbajdsjansk eller russisk.
  • Variabler, der ændres via API'et, når applikationen ved næste deploy, ligesom i panelet — {"rebuild": false} er nok.

Kommandolinjen rivervo

Deploys, logs, variabler og tilbagerulninger fra din terminal med de samme API-tokens. Den kræver Node.js 22 eller nyere:

npm install -g rivervo
rivervo login                       # indsæt tokenet
rivervo deploy shop                 # byg det seneste commit, og følg deployet
rivervo logs shop -f                # følg applikationens output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # tilbage til den forrige version

I CI læser den tokenet fra variablen RIVERVO_TOKEN, og deploy afslutter med en fejl, når den nye version ikke går live, så den kan bruges som kontrolpunkt i en pipeline. Indtil den er udgivet, kan det samme gøres med REST API'et.

«Forklar denne fejl»

Når et deploy ikke bliver færdigt, eller en tjeneste holder op med at virke, vises Forklar denne fejl ved siden af loggen. Den læser de sidste linjer i loggen og fortæller dig på dit sprog:

  • Sandsynlig årsag — hvad der gik galt;
  • Sådan retter du det — konkrete trin til din stak.

Forklaringen skrives med AI ud fra loggen; tjek den, før du ændrer noget. Før noget sendes, skjules alle værdier af dine variabler og alt, der ligner en nøgle, en adgangskode eller et token, i loggen. Din kode og selve dine variabler sendes aldrig.

Hver person kan bede om op til 10 nye forklaringer om dagen; en forklaring, der allerede er lavet til samme log, vises igen gratis.

Rivervo MCP

Du kan også arbejde med dine applikationer fra AI-assistenter via Rivervo MCP — det virker med Claude, ChatGPT, Cursor, VS Code og andre apps, der understøtter MCP: spørg til deploys, logs og fejl i en samtale, og lad assistenten deploye eller rulle tilbage for dig. Der kræves intet token; du logger ind med din Rivervo-konto. Se Rivervo MCP.

Sidder du stadig fast?

Chat med os — AI svarer med det samme, og en tekniker kommer på, når der er brug for det, uanset tidspunktet.

Kontakt support