Εργαλεία για developers: API tokens, το REST API, το CLI και «Εξήγησε αυτό το σφάλμα».
Δημιούργησε API tokens με το σωστό εύρος, δούλεψε με τις εφαρμογές από scripts και CI μέσω του REST API και της γραμμής εντολών rivervo, και πάρε εξηγήσεις από AI για αποτυχημένα deploy.
Ό,τι κάνεις με τις εφαρμογές στο 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}/deployments | deploy: 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}/logs | logs λειτουργίας της ιστοσελίδας, ενός worker ή του χρονοπρογραμματισμού | ανάγνωση |
GET, PUT, PATCH /apps/{id}/env | ανάγνωση, αντικατάσταση ή ενημέρωση μεταβλητών | πλήρης |
GET /apps/{id}/domains | domain | ανάγνωση |
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.