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.
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å:
| Omfang | Tillader |
|---|---|
| Kun læsning | applikationer, deploys og deres logs, kørselslogs, domæner |
| Læsning og deploy | læsning plus deploy, tilbagerulning og genstart |
| Fuld adgang | deploy plus variabler (læse og ændre) og domæner (tilføje, fjerne) |
| Fuld adgang og terminal | fuld 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/appsDet kan du:
| Metode og sti | Hvad den gør | Omfang |
|---|---|---|
GET /apps | dine applikationer og deres tjenester | læsning |
GET /apps/{id} | én applikation | læsning |
GET /apps/{id}/deployments | dens deploys | læsning |
POST /apps/{id}/deployments | deploy: byg det seneste commit, eller deploy den kørende version igen med {"rebuild": false} | deploy |
GET /apps/{id}/deployments/{deployment} | et deploy med build-log | læsning |
POST /apps/{id}/deployments/{deployment}/rollback | gå tilbage til den version | deploy |
POST /apps/{id}/restart | genstart | deploy |
GET /apps/{id}/logs | kørselslogs for siden, en worker eller planen | læsning |
GET, PUT, PATCH /apps/{id}/env | læs, erstat eller opdater variabler | fuld |
GET /apps/{id}/domains | domæner | læsning |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | tilføj eller fjern et domæne | fuld |
- 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
429medRetry-After. - Sprog: beskeder kommer som standard på engelsk; send
Accept-Language: azellerrufor 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 versionI 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.