Instrumente pentru dezvoltatori: tokenuri API, REST API, CLI și „Explică eroarea”.
Creează tokenuri API cu drepturile potrivite, lucrează cu aplicațiile din scripturi și CI prin REST API și linia de comandă rivervo, și primește explicații AI pentru deploy-urile eșuate.
Tot ce faci cu aplicațiile în panou poate fi și automatizat — deploy-uri din CI, variabile dintr-un script, loguri în terminal.
Tokenuri API
Setările contului → Tokenuri API → Creează un token. Dă-i un nume (unde este folosit, de exemplu „GitHub Actions”) și alege ce are voie să facă:
| Drepturi | Permite |
|---|---|
| Doar citire | aplicații, deploy-uri și logurile lor, loguri de rulare, domenii |
| Citire și deploy | citire, plus deploy, revenire și repornire |
| Acces complet | deploy, plus variabile (citire și modificare) și domenii (adăugare, eliminare) |
| Acces complet și terminal | acces complet, plus comenzi pe site-urile tale, fișierele lor, sarcinile cron, cheile SSH și deploy-urile din Git |
Poți seta și când expiră — după 30, 90 sau 365 de zile, ori niciodată.
- Tokenul se afișează o singură dată — copiază-l imediat.
- Un token acționează cu accesul tău. În contul altcuiva, acționează cu rolul tău în aplicație, iar drepturile tokenului se aplică pe deasupra. Vezi Accesul la o aplicație.
- Poți avea până la 20 de tokenuri. Revocă oprește imediat un token.
- Doar tu îți poți crea tokenurile: cineva autentificat în contul tău în numele tău nu poate.
REST API
API-ul este documentat în OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Îl poți importa în Postman, Insomnia sau într-un generator de cod.
Adresa de bază: https://api.rivervo.com/api/v1. Trimite tokenul ca bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsCe poți face:
| Metodă și cale | Ce face | Drepturi |
|---|---|---|
GET /apps | aplicațiile tale și serviciile lor | citire |
GET /apps/{id} | o aplicație | citire |
GET /apps/{id}/deployments | deploy-urile ei | citire |
POST /apps/{id}/deployments | deploy: construiește ultimul commit sau, cu {"rebuild": false}, publică din nou versiunea curentă | deploy |
GET /apps/{id}/deployments/{deployment} | un deploy cu logul lui de build | citire |
POST /apps/{id}/deployments/{deployment}/rollback | revenire la acea versiune | deploy |
POST /apps/{id}/restart | repornire | deploy |
GET /apps/{id}/logs | logurile de rulare ale site-ului, ale unui worker sau ale programului de sarcini | citire |
GET, PUT, PATCH /apps/{id}/env | citirea, înlocuirea sau actualizarea variabilelor | complet |
GET /apps/{id}/domains | domenii | citire |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | adăugarea sau eliminarea unui domeniu | complet |
- Contul altcuiva: adaugă headerul
X-Account: <the account's customer ID>ca să lucrezi cu aplicațiile unui cont la care ai primit acces. - Limite: 120 de cereri pe minut de persoană, dintre care 30 de modificări. Peste ele, API-ul răspunde cu
429șiRetry-After. - Limbă: mesajele vin implicit în engleză; trimite
Accept-Language: azsaurupentru azeră sau rusă. - Variabilele modificate prin API ajung la aplicație la următorul deploy, ca în panou — e suficient
{"rebuild": false}.
Linia de comandă rivervo
Deploy-uri, loguri, variabile și reveniri din terminal, cu aceleași tokenuri API. Are nevoie de Node.js 22 sau mai nou:
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În CI citește tokenul din variabila RIVERVO_TOKEN, iar deploy se încheie cu eroare când versiunea nouă nu ajunge live, așa că poate opri un pipeline. Până la publicarea ei, același lucru se poate face prin REST API.
„Explică eroarea”
Când un deploy nu se finalizează sau un serviciu nu mai funcționează, lângă log apare Explică eroarea. Citește ultimele rânduri din log și îți spune, în limba ta:
- Cauza probabilă — ce a mers prost;
- Cum o rezolvi — pași concreți pentru stack-ul tău.
Explicația este scrisă de AI pe baza logului; verific-o înainte să schimbi ceva. Înainte să se trimită ceva, toate valorile variabilelor tale și tot ce seamănă cu o cheie, o parolă sau un token sunt ascunse din log. Codul și variabilele tale în sine nu se trimit niciodată.
Fiecare persoană poate cere până la 10 explicații noi pe zi; o explicație deja făcută pentru același log se afișează din nou gratuit.
Rivervo MCP
Poți lucra cu aplicațiile tale și din asistenți AI prin Rivervo MCP — funcționează cu Claude, ChatGPT, Cursor, VS Code și alte aplicații care suportă MCP: întrebi despre deploy-uri, loguri și erori într-o conversație și lași asistentul să facă deploy sau să revină la o versiune anterioară în locul tău. Nu ai nevoie de token; te autentifici cu contul Rivervo. Vezi Rivervo MCP.