Începe acum

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.

4 MIN DE CITIT

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ă:

DrepturiPermite
Doar citireaplicații, deploy-uri și logurile lor, loguri de rulare, domenii
Citire și deploycitire, plus deploy, revenire și repornire
Acces completdeploy, plus variabile (citire și modificare) și domenii (adăugare, eliminare)
Acces complet și terminalacces 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/apps

Ce poți face:

Metodă și caleCe faceDrepturi
GET /appsaplicațiile tale și serviciile lorcitire
GET /apps/{id}o aplicațiecitire
GET /apps/{id}/deploymentsdeploy-urile eicitire
POST /apps/{id}/deploymentsdeploy: 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 buildcitire
POST /apps/{id}/deployments/{deployment}/rollbackrevenire la acea versiunedeploy
POST /apps/{id}/restartreporniredeploy
GET /apps/{id}/logslogurile de rulare ale site-ului, ale unui worker sau ale programului de sarcinicitire
GET, PUT, PATCH /apps/{id}/envcitirea, înlocuirea sau actualizarea variabilelorcomplet
GET /apps/{id}/domainsdomeniicitire
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}adăugarea sau eliminarea unui domeniucomplet
  • 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 și Retry-After.
  • Limbă: mesajele vin implicit în engleză; trimite Accept-Language: az sau ru pentru 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.

Încă ai întrebări?

Scrie-ne în chat — asistentul AI răspunde imediat, iar un inginer intervine când e nevoie, la orice oră.

Contactează suportul