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.
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:
| Rechten | Staat toe |
|---|---|
| Alleen lezen | applicaties, deploys en hun logs, runtimelogs, domeinen |
| Lezen en deployen | lezen, plus deployen, terugdraaien en herstarten |
| Volledige toegang | deployen, plus variabelen (lezen en wijzigen) en domeinen (toevoegen, verwijderen) |
| Volledige toegang en terminal | volledige 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/appsWat je kunt doen:
| Methode en pad | Wat het doet | Rechten |
|---|---|---|
GET /apps | je applicaties en hun diensten | lezen |
GET /apps/{id} | één applicatie | lezen |
GET /apps/{id}/deployments | de deploys ervan | lezen |
POST /apps/{id}/deployments | deployen: de nieuwste commit bouwen, of met {"rebuild": false} de draaiende versie opnieuw deployen | deployen |
GET /apps/{id}/deployments/{deployment} | een deploy met zijn buildlog | lezen |
POST /apps/{id}/deployments/{deployment}/rollback | terug naar die versie | deployen |
POST /apps/{id}/restart | herstarten | deployen |
GET /apps/{id}/logs | runtimelogs van de site, een worker of de planning | lezen |
GET, PUT, PATCH /apps/{id}/env | variabelen lezen, vervangen of bijwerken | volledig |
GET /apps/{id}/domains | domeinen | lezen |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | een domein toevoegen of verwijderen | volledig |
- 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
429enRetry-After. - Taal: berichten komen standaard in het Engels; stuur
Accept-Language: azofruvoor 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 versionIn 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.