Utvecklarverktyg: API-tokens, REST API, CLI och «Förklara felet».
Skapa API-tokens med rätt behörighet, arbeta med applikationer från skript och CI via REST API:et, kommandoraden rivervo och förklaringar från AI av misslyckade driftsättningar.
Allt du gör med applikationer i panelen kan också skriptas – driftsättningar från CI, variabler från ett skript, loggar i din terminal.
API-tokens
Kontoinställningar → API-tokens → Skapa en token. Ge den ett namn (där den används, t.ex. «GitHub Actions») och välj vad den får göra:
| Behörighet | Tillåter |
|---|---|
| Endast läsning | applikationer, driftsättningar och deras loggar, körloggar, domäner |
| Läsa och driftsätta | läsning, plus driftsättning, återställning och omstart |
| Full åtkomst | driftsättning, plus variabler (läsa och ändra) och domäner (lägga till, ta bort) |
| Full åtkomst och terminal | full åtkomst, plus kommandon på dina webbplatser, deras filer, cron-jobb, SSH-nycklar och driftsättning från Git |
Du kan också ange när den ska upphöra – efter 30, 90 eller 365 dagar, eller aldrig.
- Token visas en gång – kopiera den direkt.
- En token agerar med din åtkomst. I någon annans konto agerar den med din roll i applikationen, och tokenens behörighet gäller ovanpå det. Se Åtkomst till en applikation.
- Du kan ha upp till 20 tokens. Återkalla stoppar en token direkt.
- Bara du kan skapa dina tokens: någon som är inloggad på ditt konto för din räkning kan inte göra det.
REST API:et
API:et är dokumenterat i OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importera det i Postman, Insomnia eller en kodgenerator.
Basadress: https://api.rivervo.com/api/v1. Skicka token som en bearer-token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsDet här kan du göra:
| Metod och sökväg | Vad den gör | Behörighet |
|---|---|---|
GET /apps | dina applikationer och deras tjänster | läsa |
GET /apps/{id} | en applikation | läsa |
GET /apps/{id}/deployments | dess driftsättningar | läsa |
POST /apps/{id}/deployments | driftsätt: bygg den senaste committen, eller med {"rebuild": false} driftsätt den körande versionen igen | driftsätta |
GET /apps/{id}/deployments/{deployment} | en driftsättning med dess bygglogg | läsa |
POST /apps/{id}/deployments/{deployment}/rollback | gå tillbaka till den versionen | driftsätta |
POST /apps/{id}/restart | starta om | driftsätta |
GET /apps/{id}/logs | körloggar för webbplatsen, en worker eller schemat | läsa |
GET, PUT, PATCH /apps/{id}/env | läsa, ersätta eller uppdatera variabler | full |
GET /apps/{id}/domains | domäner | läsa |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | lägga till eller ta bort en domän | full |
- Någon annans konto: lägg till headern
X-Account: <kontots kund-ID>för att arbeta med applikationerna i ett konto du har fått åtkomst till. - Gränser: 120 förfrågningar per minut och person, varav 30 ändringar. Över det svarar API:et
429medRetry-After. - Språk: meddelanden kommer på engelska som standard. Skicka
Accept-Language: azellerruför azerbajdzjanska eller ryska. - Variabler som ändras via API:et når applikationen vid nästa driftsättning, precis som i panelen –
{"rebuild": false}räcker.
Kommandoraden rivervo
Driftsättningar, loggar, variabler och återställningar från din terminal, med samma API-tokens. Den kräver Node.js 22 eller senare:
npm install -g rivervo
rivervo login # klistra in din token
rivervo deploy shop # bygg den senaste committen och följ driftsättningen
rivervo logs shop -f # följ applikationens utdata
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # tillbaka till föregående versionI CI läser den token från variabeln RIVERVO_TOKEN, och deploy avslutas med ett fel när den nya versionen inte går live, så den kan stoppa en pipeline. Tills den är publicerad kan samma sak göras med REST API:et.
«Förklara felet»
När en driftsättning inte blir klar, eller en tjänst slutar fungera, visas Förklara felet bredvid loggen. Den läser de sista raderna i loggen och berättar, på ditt språk:
- Trolig orsak – vad som gick fel;
- Så åtgärdar du det – konkreta steg för din stack.
Förklaringen skrivs av AI utifrån loggen – kontrollera den innan du ändrar något. Innan något skickas döljs alla värden för dina variabler och allt som ser ut som en nyckel, ett lösenord eller en token i loggen. Din kod och själva variablerna skickas aldrig.
Varje person kan be om upp till 10 nya förklaringar per dag. En förklaring som redan har gjorts för samma logg visas igen utan kostnad.
Rivervo MCP
Du kan också arbeta med dina applikationer från AI-assistenter via Rivervo MCP – det fungerar med Claude, ChatGPT, Cursor, VS Code och andra appar som stöder MCP: fråga om driftsättningar, loggar och fel i en konversation, och låt assistenten driftsätta eller återställa åt dig. Ingen token behövs – du loggar in med ditt Rivervo-konto. Se Rivervo MCP.