Kom igång

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.

4 MIN LÄSNING

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örighetTillåter
Endast läsningapplikationer, driftsättningar och deras loggar, körloggar, domäner
Läsa och driftsättaläsning, plus driftsättning, återställning och omstart
Full åtkomstdriftsättning, plus variabler (läsa och ändra) och domäner (lägga till, ta bort)
Full åtkomst och terminalfull å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/apps

Det här kan du göra:

Metod och sökvägVad den görBehörighet
GET /appsdina applikationer och deras tjänsterläsa
GET /apps/{id}en applikationläsa
GET /apps/{id}/deploymentsdess driftsättningarläsa
POST /apps/{id}/deploymentsdriftsätt: bygg den senaste committen, eller med {"rebuild": false} driftsätt den körande versionen igendriftsätta
GET /apps/{id}/deployments/{deployment}en driftsättning med dess byggloggläsa
POST /apps/{id}/deployments/{deployment}/rollbackgå tillbaka till den versionendriftsätta
POST /apps/{id}/restartstarta omdriftsätta
GET /apps/{id}/logskörloggar för webbplatsen, en worker eller schematläsa
GET, PUT, PATCH /apps/{id}/envläsa, ersätta eller uppdatera variablerfull
GET /apps/{id}/domainsdomänerläsa
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}lägga till eller ta bort en domänfull
  • 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 429 med Retry-After.
  • Språk: meddelanden kommer på engelska som standard. Skicka Accept-Language: az eller ru fö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 version

I 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.

Fortfarande fast?

Chatta med oss — AI svarar direkt och en tekniker kopplas in vid behov, när som helst på dygnet.

Kontakta supporten