Ξεκίνα

Εργαλεία για developers: API tokens, το REST API, το CLI και «Εξήγησε αυτό το σφάλμα».

Δημιούργησε API tokens με το σωστό εύρος, δούλεψε με τις εφαρμογές από scripts και CI μέσω του REST API και της γραμμής εντολών rivervo, και πάρε εξηγήσεις από AI για αποτυχημένα deploy.

4 ΛΕΠΤΑ ΑΝΑΓΝΩΣΗΣ

Ό,τι κάνεις με τις εφαρμογές στο panel μπορεί να γίνει και με scripts — deploy από CI, μεταβλητές από ένα script, logs στο τερματικό σου.

API tokens

Ρυθμίσεις λογαριασμού → API tokens → Δημιουργία token. Δώσε του ένα όνομα (πού χρησιμοποιείται, π.χ. «GitHub Actions») και επίλεξε τι επιτρέπεται να κάνει:

ΕύροςΕπιτρέπει
Μόνο ανάγνωσηεφαρμογές, deploy και τα logs τους, logs λειτουργίας, domain
Ανάγνωση και deployανάγνωση, και επιπλέον deploy, επιστροφή έκδοσης και επανεκκίνηση
Πλήρης πρόσβασηdeploy, και επιπλέον μεταβλητές (ανάγνωση και αλλαγή) και domain (προσθήκη, αφαίρεση)
Πλήρης πρόσβαση και τερματικόπλήρης πρόσβαση, και επιπλέον εντολές στις ιστοσελίδες σου, τα αρχεία τους, εργασίες cron, κλειδιά SSH και deploy από Git

Μπορείς επίσης να ορίσεις πότε λήγει — μετά από 30, 90 ή 365 ημέρες, ή ποτέ.

  • Το token εμφανίζεται μία φορά — αντίγραψέ το αμέσως.
  • Ένα token ενεργεί με τη δική σου πρόσβαση. Σε λογαριασμό άλλου, ενεργεί με τον ρόλο σου στην εφαρμογή, και από πάνω ισχύει το εύρος του token. Δες Πρόσβαση σε μια εφαρμογή.
  • Μπορείς να έχεις έως 20 tokens. Η Ανάκληση σταματά αμέσως ένα token.
  • Μόνο εσύ μπορείς να δημιουργήσεις τα tokens σου: κάποιος που έχει συνδεθεί στον λογαριασμό σου εκ μέρους σου δεν μπορεί.

Το REST API

Το API είναι τεκμηριωμένο σε OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Κάνε το import σε Postman, Insomnia ή σε κάποιο code generator.

Βασική διεύθυνση: https://api.rivervo.com/api/v1. Στείλε το token ως bearer token:

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

Τι μπορείς να κάνεις:

Μέθοδος και διαδρομήΤι κάνειΕύρος
GET /appsοι εφαρμογές σου και οι υπηρεσίες τουςανάγνωση
GET /apps/{id}μία εφαρμογήανάγνωση
GET /apps/{id}/deploymentsτα deploy τηςανάγνωση
POST /apps/{id}/deploymentsdeploy: build του τελευταίου commit ή, με {"rebuild": false}, ξανά deploy της τρέχουσας έκδοσηςdeploy
GET /apps/{id}/deployments/{deployment}ένα deploy με το log του buildανάγνωση
POST /apps/{id}/deployments/{deployment}/rollbackεπιστροφή σε εκείνη την έκδοσηdeploy
POST /apps/{id}/restartεπανεκκίνησηdeploy
GET /apps/{id}/logslogs λειτουργίας της ιστοσελίδας, ενός worker ή του χρονοπρογραμματισμούανάγνωση
GET, PUT, PATCH /apps/{id}/envανάγνωση, αντικατάσταση ή ενημέρωση μεταβλητώνπλήρης
GET /apps/{id}/domainsdomainανάγνωση
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}προσθήκη ή αφαίρεση domainπλήρης
  • Λογαριασμός άλλου: πρόσθεσε το header X-Account: <ο αριθμός πελάτη του λογαριασμού> για να δουλέψεις με τις εφαρμογές ενός λογαριασμού στον οποίο σου δόθηκε πρόσβαση.
  • Όρια: 120 αιτήματα το λεπτό ανά άτομο, από τα οποία 30 αλλαγές. Πέρα από αυτά το API απαντά 429 με Retry-After.
  • Γλώσσα: τα μηνύματα έρχονται από προεπιλογή στα αγγλικά· στείλε Accept-Language: az ή ru για αζερικά ή ρωσικά.
  • Οι μεταβλητές που αλλάζουν μέσω του API φτάνουν στην εφαρμογή με το επόμενο deploy της, όπως και στο panel — αρκεί το {"rebuild": false}.

Η γραμμή εντολών rivervo

Deploy, logs, μεταβλητές και επιστροφές εκδόσεων από το τερματικό σου, με τα ίδια API tokens. Χρειάζεται Node.js 22 ή νεότερο:

npm install -g rivervo
rivervo login                       # επικόλλησε το token
rivervo deploy shop                 # build του τελευταίου commit και παρακολούθηση του deploy
rivervo logs shop -f                # παρακολούθηση της εξόδου της εφαρμογής
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # επιστροφή στην προηγούμενη έκδοση

Στο CI διαβάζει το token από τη μεταβλητή RIVERVO_TOKEN, και το deploy τερματίζει με σφάλμα όταν η νέα έκδοση δεν γίνει live, οπότε μπορεί να ελέγχει ένα pipeline. Μέχρι να δημοσιευτεί, το ίδιο γίνεται με το REST API.

«Εξήγησε αυτό το σφάλμα»

Όταν ένα deploy δεν ολοκληρωθεί ή μια υπηρεσία σταματήσει να λειτουργεί, εμφανίζεται το Εξήγησε αυτό το σφάλμα δίπλα στο log. Διαβάζει τις τελευταίες γραμμές του log και σου λέει, στη γλώσσα σου:

  • Πιθανή αιτία — τι πήγε στραβά·
  • Πώς να το διορθώσεις — συγκεκριμένα βήματα για το stack σου.

Την εξήγηση τη γράφει το AI με βάση το log· έλεγξέ την πριν αλλάξεις οτιδήποτε. Πριν σταλεί οτιδήποτε, κάθε τιμή των μεταβλητών σου και ό,τι μοιάζει με κλειδί, κωδικό ή token κρύβεται από το log. Ο κώδικάς σου και οι ίδιες οι μεταβλητές σου δεν στέλνονται ποτέ.

Κάθε άτομο μπορεί να ζητήσει έως 10 νέες εξηγήσεις την ημέρα· μια εξήγηση που έχει ήδη γίνει για το ίδιο log εμφανίζεται ξανά δωρεάν.

Rivervo MCP

Μπορείς επίσης να δουλεύεις με τις εφαρμογές σου από βοηθούς AI μέσω του Rivervo MCP — λειτουργεί με Claude, ChatGPT, Cursor, VS Code και άλλες εφαρμογές που υποστηρίζουν MCP: ρώτα για deploy, logs και σφάλματα σε μια συζήτηση και άφησε τον βοηθό να κάνει deploy ή επιστροφή έκδοσης για σένα. Δεν χρειάζεται token· συνδέεσαι με τον λογαριασμό σου στη Rivervo. Δες Rivervo MCP.

Χρειάζεσαι ακόμα βοήθεια;

Γράψε μας στο chat — το AI απαντά αμέσως και ένας μηχανικός μπαίνει όταν χρειαστεί, οποιαδήποτε ώρα της μέρας.

Επικοινωνία με την υποστήριξη