Entwicklerwerkzeuge: API-Tokens, REST-API, CLI und „Diesen Fehler erklären“.
API-Tokens mit passendem Berechtigungsumfang erstellen, über die REST-API aus Skripten und CI mit Anwendungen arbeiten, die rivervo-Kommandozeile nutzen und fehlgeschlagene Deployments von AI erklären lassen.
Alles, was Sie im Panel mit Anwendungen tun, lässt sich auch automatisieren – Deployments aus der CI, Variablen per Skript, Logs im Terminal.
API-Tokens
Kontoeinstellungen → API-Tokens → Token erstellen. Geben Sie ihm einen Namen (wo er verwendet wird, z. B. „GitHub Actions“) und wählen Sie, was er darf:
| Umfang | Erlaubt |
|---|---|
| Nur lesen | Anwendungen, Deployments und ihre Logs, Laufzeit-Logs, Domains |
| Lesen und deployen | Lesen, dazu Deployen, Zurückrollen und Neustarten |
| Vollzugriff | Deployen, dazu Variablen (lesen und ändern) und Domains (hinzufügen, entfernen) |
| Vollzugriff und Terminal | Vollzugriff, dazu Befehle auf Ihren Websites, deren Dateien, Cronjobs, SSH-Schlüssel und Deployments aus Git |
Sie können auch festlegen, wann er abläuft – nach 30, 90 oder 365 Tagen oder nie.
- Der Token wird nur einmal angezeigt – kopieren Sie ihn sofort.
- Ein Token handelt mit Ihren Rechten. In einem fremden Konto handelt er mit Ihrer Rolle in der Anwendung, und der Umfang des Tokens gilt zusätzlich. Siehe Zugriff auf eine Anwendung.
- Sie können bis zu 20 Tokens besitzen. Widerrufen deaktiviert einen Token sofort.
- Nur Sie selbst können Ihre Tokens erstellen: Jemand, der sich in Ihrem Auftrag in Ihrem Konto anmeldet, kann es nicht.
Die REST-API
Die API ist in OpenAPI 3.1 dokumentiert: api.rivervo.com/api/v1/openapi.json. Importieren Sie sie in Postman, Insomnia oder einen Code-Generator.
Basisadresse: https://api.rivervo.com/api/v1. Senden Sie den Token als Bearer-Token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsWas Sie tun können:
| Methode und Pfad | Funktion | Umfang |
|---|---|---|
GET /apps | Ihre Anwendungen und deren Dienste | Lesen |
GET /apps/{id} | eine Anwendung | Lesen |
GET /apps/{id}/deployments | ihre Deployments | Lesen |
POST /apps/{id}/deployments | Deployment: neuesten Commit bauen oder mit {"rebuild": false} die laufende Version erneut deployen | Deployen |
GET /apps/{id}/deployments/{deployment} | ein Deployment mit seinem Build-Log | Lesen |
POST /apps/{id}/deployments/{deployment}/rollback | zu dieser Version zurückkehren | Deployen |
POST /apps/{id}/restart | Neustart | Deployen |
GET /apps/{id}/logs | Laufzeit-Logs der Website, eines Workers oder des Zeitplans | Lesen |
GET, PUT, PATCH /apps/{id}/env | Variablen lesen, ersetzen oder aktualisieren | Voll |
GET /apps/{id}/domains | Domains | Lesen |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | eine Domain hinzufügen oder entfernen | Voll |
- Fremdes Konto: Fügen Sie den Header
X-Account: <the account's customer ID>hinzu, um mit den Anwendungen eines Kontos zu arbeiten, auf das Sie Zugriff erhalten haben (als Wert die Kundennummer dieses Kontos). - Limits: 120 Anfragen pro Minute und Person, davon 30 Änderungen. Darüber hinaus antwortet die API mit
429undRetry-After. - Sprache: Meldungen kommen standardmäßig auf Englisch; senden Sie
Accept-Language: azoderrufür Aserbaidschanisch oder Russisch. - Über die API geänderte Variablen erreichen die Anwendung wie im Panel mit dem nächsten Deployment –
{"rebuild": false}genügt.
Die Kommandozeile rivervo
Deployments, Logs, Variablen und Rollbacks aus dem Terminal, mit denselben API-Tokens. Erforderlich ist Node.js 22 oder neuer:
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 der CI liest sie den Token aus der Variablen RIVERVO_TOKEN, und deploy endet mit einem Fehler, wenn die neue Version nicht live geht – so kann sie eine Pipeline absichern. Bis sie veröffentlicht ist, erreichen Sie dasselbe mit der REST-API.
„Diesen Fehler erklären“
Wenn ein Deployment nicht abgeschlossen wird oder ein Dienst nicht mehr funktioniert, erscheint neben dem Log Diesen Fehler erklären. Die Funktion liest die letzten Zeilen des Logs und nennt Ihnen in Ihrer Sprache:
- Wahrscheinliche Ursache – was schiefgelaufen ist;
- So beheben Sie es – konkrete Schritte für Ihren Stack.
Die Erklärung wird von AI anhand des Logs geschrieben; prüfen Sie sie, bevor Sie etwas ändern. Bevor etwas gesendet wird, werden alle Werte Ihrer Variablen und alles, was nach Schlüssel, Passwort oder Token aussieht, im Log verborgen. Ihr Code und Ihre Variablen selbst werden nie gesendet.
Jede Person kann bis zu 10 neue Erklärungen pro Tag anfordern; eine für dasselbe Log bereits erstellte Erklärung wird kostenlos erneut angezeigt.
Rivervo MCP
Sie können mit Ihren Anwendungen auch über Rivervo MCP aus AI-Assistenten heraus arbeiten – das funktioniert mit Claude, ChatGPT, Cursor, VS Code und anderen Apps, die MCP unterstützen: Fragen Sie im Gespräch nach Deployments, Logs und Fehlern und lassen Sie den Assistenten für Sie deployen oder zurückrollen. Ein Token ist nicht nötig; Sie melden sich mit Ihrem Rivervo-Konto an. Siehe Rivervo MCP.