Inizia ora

Strumenti per sviluppatori: token API, REST API, CLI e «Spiega questo errore».

Crea token API con i permessi giusti, gestisci le applicazioni da script e CI tramite la REST API e la riga di comando rivervo, e ricevi dall'AI spiegazioni dei deploy non riusciti.

4 MIN DI LETTURA

Tutto ciò che fai con le applicazioni nel pannello si può anche automatizzare con script — deploy dalla CI, variabili da uno script, log nel tuo terminale.

Token API

Impostazioni dell'account → Token API → Crea un token. Dagli un nome (dove viene usato, ad esempio «GitHub Actions») e scegli cosa può fare:

PermessiConsente
Solo letturaapplicazioni, deploy e relativi log, log di runtime, domini
Lettura e deploylettura, più deploy, rollback e riavvio
Accesso completodeploy, più variabili (lettura e modifica) e domini (aggiunta, rimozione)
Accesso completo e terminaleaccesso completo, più comandi sui tuoi siti web, i loro file, cron job, chiavi SSH e deploy da Git

Puoi anche impostare quando scade — dopo 30, 90 o 365 giorni, oppure mai.

  • Il token viene mostrato una sola volta — copialo subito.
  • Un token agisce con il tuo accesso. Nell'account di qualcun altro agisce con il tuo ruolo nell'applicazione, e in più si applicano i permessi del token. Vedi Accesso a un'applicazione.
  • Puoi avere fino a 20 token. Revoca disattiva subito un token.
  • Solo tu puoi creare i tuoi token: chi accede al tuo account per conto tuo non può farlo.

La REST API

L'API è documentata in OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importala in Postman, Insomnia o in un generatore di codice.

Indirizzo di base: https://api.rivervo.com/api/v1. Invia il token come bearer token:

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

Cosa puoi fare:

Metodo e percorsoCosa faPermessi
GET /appsle tue applicazioni e i loro servizilettura
GET /apps/{id}una singola applicazionelettura
GET /apps/{id}/deploymentsi suoi deploylettura
POST /apps/{id}/deploymentsdeploy: compila l'ultimo commit, oppure con {"rebuild": false} ripubblica la versione in esecuzionedeploy
GET /apps/{id}/deployments/{deployment}un deploy con il suo log di buildlettura
POST /apps/{id}/deployments/{deployment}/rollbacktorna a quella versionedeploy
POST /apps/{id}/restartriavviodeploy
GET /apps/{id}/logslog di runtime del sito, di un worker o della pianificazionelettura
GET, PUT, PATCH /apps/{id}/envlegge, sostituisce o aggiorna le variabilicompleto
GET /apps/{id}/domainsdominilettura
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}aggiunge o rimuove un dominiocompleto
  • Account di qualcun altro: aggiungi l'header X-Account: <the account's customer ID> (l'ID cliente dell'account) per lavorare con le applicazioni di un account a cui ti è stato dato accesso.
  • Limiti: 120 richieste al minuto per persona, di cui 30 modifiche. Oltre questi limiti l'API risponde 429 con Retry-After.
  • Lingua: i messaggi arrivano in inglese per impostazione predefinita; invia Accept-Language: az o ru per l'azero o il russo.
  • Le variabili modificate tramite l'API arrivano all'applicazione con il deploy successivo, come nel pannello — basta {"rebuild": false}.

La riga di comando rivervo

Deploy, log, variabili e rollback dal tuo terminale, con gli stessi token API. Richiede Node.js 22 o successivo:

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

Nella CI legge il token dalla variabile RIVERVO_TOKEN, e deploy termina con un errore quando la nuova versione non va online, quindi può fare da controllo in una pipeline. Finché non viene pubblicata, puoi fare lo stesso con la REST API.

«Spiega questo errore»

Quando un deploy non va a buon fine, o un servizio smette di funzionare, accanto al log compare Spiega questo errore. Legge le ultime righe del log e ti dice, nella tua lingua:

  • Causa probabile — cosa è andato storto;
  • Come risolvere — passaggi concreti per il tuo stack.

La spiegazione viene scritta dall'AI a partire dal log; verificala prima di modificare qualcosa. Prima di inviare qualsiasi cosa, tutti i valori delle tue variabili e tutto ciò che sembra una chiave, una password o un token vengono nascosti nel log. Il tuo codice e le tue variabili non vengono mai inviati.

Ogni persona può chiedere fino a 10 nuove spiegazioni al giorno; una spiegazione già generata per lo stesso log viene mostrata di nuovo gratuitamente.

Rivervo MCP

Puoi lavorare con le tue applicazioni anche dagli assistenti AI tramite Rivervo MCP — funziona con Claude, ChatGPT, Cursor, VS Code e altre app che supportano MCP: chiedi di deploy, log ed errori in una conversazione e lascia che sia l'assistente a fare deploy o rollback per te. Non serve alcun token; accedi con il tuo account Rivervo. Vedi Rivervo MCP.

Hai ancora dubbi?

Scrivici in chat: l'AI risponde subito e un tecnico si unisce quando serve, a qualsiasi ora.

Contatta l'assistenza