Jetzt starten

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.

4 MIN. LESEZEIT

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:

UmfangErlaubt
Nur lesenAnwendungen, Deployments und ihre Logs, Laufzeit-Logs, Domains
Lesen und deployenLesen, dazu Deployen, Zurückrollen und Neustarten
VollzugriffDeployen, dazu Variablen (lesen und ändern) und Domains (hinzufügen, entfernen)
Vollzugriff und TerminalVollzugriff, 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/apps

Was Sie tun können:

Methode und PfadFunktionUmfang
GET /appsIhre Anwendungen und deren DiensteLesen
GET /apps/{id}eine AnwendungLesen
GET /apps/{id}/deploymentsihre DeploymentsLesen
POST /apps/{id}/deploymentsDeployment: neuesten Commit bauen oder mit {"rebuild": false} die laufende Version erneut deployenDeployen
GET /apps/{id}/deployments/{deployment}ein Deployment mit seinem Build-LogLesen
POST /apps/{id}/deployments/{deployment}/rollbackzu dieser Version zurückkehrenDeployen
POST /apps/{id}/restartNeustartDeployen
GET /apps/{id}/logsLaufzeit-Logs der Website, eines Workers oder des ZeitplansLesen
GET, PUT, PATCH /apps/{id}/envVariablen lesen, ersetzen oder aktualisierenVoll
GET /apps/{id}/domainsDomainsLesen
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}eine Domain hinzufügen oder entfernenVoll
  • 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 429 und Retry-After.
  • Sprache: Meldungen kommen standardmäßig auf Englisch; senden Sie Accept-Language: az oder ru fü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 version

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

Noch Fragen?

Schreiben Sie uns im Chat – die AI antwortet sofort, und bei Bedarf kommt ein Techniker dazu, zu jeder Tageszeit.

Support kontaktieren