Aan de slag

Ontwikkelaarstools: API-tokens, de REST API, de CLI en «Leg deze fout uit».

Maak API-tokens met de juiste rechten, werk met applicaties vanuit scripts en CI via de REST API en de rivervo-opdrachtregel, en krijg uitleg van AI bij mislukte deploys.

4 MIN LEESTIJD

Alles wat je in het paneel met applicaties doet, kun je ook scripten — deploys vanuit CI, variabelen vanuit een script, logs in je terminal.

API-tokens

Accountinstellingen → API-tokens → Token aanmaken. Geef het token een naam (waar het gebruikt wordt, bijv. «GitHub Actions») en kies wat het mag:

RechtenStaat toe
Alleen lezenapplicaties, deploys en hun logs, runtimelogs, domeinen
Lezen en deployenlezen, plus deployen, terugdraaien en herstarten
Volledige toegangdeployen, plus variabelen (lezen en wijzigen) en domeinen (toevoegen, verwijderen)
Volledige toegang en terminalvolledige toegang, plus opdrachten op je websites, hun bestanden, cronjobs, SSH-sleutels en deploys vanuit Git

Je kunt ook instellen wanneer het verloopt — na 30, 90 of 365 dagen, of nooit.

  • Het token wordt één keer getoond — kopieer het meteen.
  • Een token werkt met jouw toegang. In het account van iemand anders werkt het met jouw rol in de applicatie, en de rechten van het token gelden daar bovenop. Zie Toegang tot een applicatie.
  • Je kunt maximaal 20 tokens hebben. Intrekken zet een token meteen buiten werking.
  • Alleen jij kunt je tokens aanmaken: iemand die namens jou in je account is ingelogd, kan dat niet.

De REST API

De API is beschreven in OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importeer die in Postman, Insomnia of een codegenerator.

Basisadres: https://api.rivervo.com/api/v1. Stuur het token mee als bearer-token:

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

Wat je kunt doen:

Methode en padWat het doetRechten
GET /appsje applicaties en hun dienstenlezen
GET /apps/{id}één applicatielezen
GET /apps/{id}/deploymentsde deploys ervanlezen
POST /apps/{id}/deploymentsdeployen: de nieuwste commit bouwen, of met {"rebuild": false} de draaiende versie opnieuw deployendeployen
GET /apps/{id}/deployments/{deployment}een deploy met zijn buildloglezen
POST /apps/{id}/deployments/{deployment}/rollbackterug naar die versiedeployen
POST /apps/{id}/restartherstartendeployen
GET /apps/{id}/logsruntimelogs van de site, een worker of de planninglezen
GET, PUT, PATCH /apps/{id}/envvariabelen lezen, vervangen of bijwerkenvolledig
GET /apps/{id}/domainsdomeinenlezen
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}een domein toevoegen of verwijderenvolledig
  • Account van iemand anders: voeg de header X-Account: <the account's customer ID> toe om te werken met de applicaties van een account waartoe je toegang hebt gekregen.
  • Limieten: 120 verzoeken per minuut per persoon, waarvan 30 wijzigingen. Daarboven antwoordt de API met 429 en Retry-After.
  • Taal: berichten komen standaard in het Engels; stuur Accept-Language: az of ru voor Azerbeidzjaans of Russisch.
  • Variabelen die je via de API wijzigt, komen bij de volgende deploy in de applicatie, net als in het paneel — {"rebuild": false} is genoeg.

De rivervo-opdrachtregel

Deploys, logs, variabelen en terugdraaien vanuit je terminal, met dezelfde API-tokens. Je hebt Node.js 22 of nieuwer nodig:

npm install -g rivervo
rivervo login                       # paste the token
rivervo deploy shop                 # build the latest commit and follow the deploy
rivervo logs shop -f                # follow the application's output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # back to the previous version

In CI leest de CLI het token uit de variabele RIVERVO_TOKEN, en deploy stopt met een fout als de nieuwe versie niet live gaat, zodat je er een pipeline mee kunt tegenhouden. Tot de CLI gepubliceerd is, kun je hetzelfde doen met de REST API.

«Leg deze fout uit»

Rondt een deploy niet af of stopt een dienst met werken, dan verschijnt Leg deze fout uit naast het log. Die leest de laatste regels van het log en vertelt je, in je eigen taal:

  • Waarschijnlijke oorzaak — wat er misging;
  • Zo los je het op — concrete stappen voor jouw stack.

De uitleg wordt door AI geschreven op basis van het log; controleer die voordat je iets wijzigt. Voordat er iets wordt verstuurd, worden alle waarden van je variabelen en alles wat op een sleutel, wachtwoord of token lijkt uit het log verborgen. Je code en je variabelen zelf worden nooit verstuurd.

Iedereen kan maximaal 10 nieuwe uitleggen per dag vragen; een uitleg die al voor hetzelfde log is gemaakt, wordt gratis opnieuw getoond.

Rivervo MCP

Je kunt ook met je applicaties werken vanuit AI-assistenten via Rivervo MCP — dat werkt met Claude, ChatGPT, Cursor, VS Code en andere apps die MCP ondersteunen: stel in een gesprek vragen over deploys, logs en fouten, en laat de assistent voor je deployen of terugdraaien. Je hebt geen token nodig; je logt in met je Rivervo-account. Zie Rivervo MCP.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support