Outils pour développeurs : jetons API, API REST, CLI et « Expliquer cette erreur ».
Créez des jetons API avec les bons droits, pilotez vos applications depuis vos scripts et votre CI via l'API REST ou la ligne de commande rivervo, et obtenez des explications AI des déploiements échoués.
Tout ce que vous faites avec les applications dans le panel peut aussi être automatisé : déploiements depuis la CI, variables depuis un script, journaux dans votre terminal.
Jetons API
Paramètres du compte → Jetons API → Créer un jeton. Donnez-lui un nom (là où il sert, par exemple « GitHub Actions ») et choisissez ce qu'il peut faire :
| Portée | Autorise |
|---|---|
| Lecture seule | applications, déploiements et leurs journaux, journaux d'exécution, domaines |
| Lecture et déploiement | la lecture, plus le déploiement, le retour en arrière et le redémarrage |
| Accès complet | le déploiement, plus les variables (lecture et modification) et les domaines (ajout, suppression) |
| Accès complet et terminal | l'accès complet, plus les commandes sur vos sites web, leurs fichiers, les tâches cron, les clés SSH et les déploiements depuis Git |
Vous pouvez aussi choisir quand il expire : au bout de 30, 90 ou 365 jours, ou jamais.
- Le jeton n'est affiché qu'une fois : copiez-le tout de suite.
- Un jeton agit avec vos droits. Dans le compte de quelqu'un d'autre, il agit avec votre rôle dans l'application, et la portée du jeton s'applique en plus. Voir Accès à une application.
- Vous pouvez avoir jusqu'à 20 jetons. Révoquer désactive un jeton immédiatement.
- Vous seul pouvez créer vos jetons : une personne connectée à votre compte en votre nom ne le peut pas.
L'API REST
L'API est documentée en OpenAPI 3.1 : api.rivervo.com/api/v1/openapi.json. Importez-la dans Postman, Insomnia ou un générateur de code.
Adresse de base : https://api.rivervo.com/api/v1. Envoyez le jeton en tant que bearer token :
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsCe que vous pouvez faire :
| Méthode et chemin | Action | Portée |
|---|---|---|
GET /apps | vos applications et leurs services | lecture |
GET /apps/{id} | une application | lecture |
GET /apps/{id}/deployments | ses déploiements | lecture |
POST /apps/{id}/deployments | déployer : construire le dernier commit, ou avec {"rebuild": false} redéployer la version en cours | déploiement |
GET /apps/{id}/deployments/{deployment} | un déploiement avec son journal de build | lecture |
POST /apps/{id}/deployments/{deployment}/rollback | revenir à cette version | déploiement |
POST /apps/{id}/restart | redémarrer | déploiement |
GET /apps/{id}/logs | journaux d'exécution du site, d'un worker ou des tâches planifiées | lecture |
GET, PUT, PATCH /apps/{id}/env | lire, remplacer ou mettre à jour les variables | complet |
GET /apps/{id}/domains | domaines | lecture |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | ajouter ou retirer un domaine | complet |
- Compte de quelqu'un d'autre : ajoutez l'en-tête
X-Account: <the account's customer ID>pour travailler sur les applications d'un compte auquel on vous a donné accès. - Limites : 120 requêtes par minute et par personne, dont 30 modifications. Au-delà, l'API répond
429avecRetry-After. - Langue : les messages sont en anglais par défaut ; envoyez
Accept-Language: azourupour l'azerbaïdjanais ou le russe. - Les variables modifiées via l'API parviennent à l'application à son prochain déploiement, comme dans le panel :
{"rebuild": false}suffit.
La ligne de commande rivervo
Déploiements, journaux, variables et retours en arrière depuis votre terminal, avec les mêmes jetons API. Elle nécessite Node.js 22 ou plus récent :
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 versionEn CI, elle lit le jeton dans la variable RIVERVO_TOKEN, et deploy se termine en erreur quand la nouvelle version n'est pas mise en ligne : elle peut donc servir de garde-fou dans un pipeline. Tant qu'elle n'est pas publiée, vous pouvez faire la même chose avec l'API REST.
« Expliquer cette erreur »
Quand un déploiement n'aboutit pas ou qu'un service cesse de fonctionner, Expliquer cette erreur apparaît à côté du journal. L'outil lit les dernières lignes du journal et vous indique, dans votre langue :
- Cause probable : ce qui n'a pas fonctionné ;
- Comment corriger : des étapes concrètes pour votre stack.
L'explication est rédigée par l'AI à partir du journal ; vérifiez-la avant de modifier quoi que ce soit. Avant tout envoi, chaque valeur de vos variables et tout ce qui ressemble à une clé, un mot de passe ou un jeton est masqué dans le journal. Votre code et vos variables elles-mêmes ne sont jamais envoyés.
Chaque personne peut demander jusqu'à 10 nouvelles explications par jour ; une explication déjà faite pour le même journal est réaffichée gratuitement.
Rivervo MCP
Vous pouvez aussi travailler sur vos applications depuis des assistants AI grâce à Rivervo MCP, compatible avec Claude, ChatGPT, Cursor, VS Code et les autres applications qui prennent en charge MCP : posez vos questions sur les déploiements, les journaux et les erreurs au fil de la conversation, et laissez l'assistant déployer ou revenir en arrière pour vous. Aucun jeton n'est nécessaire : vous vous connectez avec votre compte Rivervo. Voir Rivervo MCP.