Começar

Ferramentas para programadores: tokens de API, a API REST, a CLI e «Explicar este erro».

Crie tokens de API com o âmbito certo, trabalhe com as aplicações a partir de scripts e de CI através da API REST e da linha de comandos rivervo, e obtenha explicações de deploys falhados feitas pela AI.

4 MIN DE LEITURA

Tudo o que faz com as aplicações no painel também pode ser automatizado — deploys a partir de CI, variáveis a partir de um script, registos no seu terminal.

Tokens de API

Definições da conta → Tokens de API → Criar um token. Dê-lhe um nome (onde vai ser usado, por exemplo «GitHub Actions») e escolha o que pode fazer:

ÂmbitoPermite
Só leituraaplicações, deploys e respetivos registos, registos de execução, domínios
Leitura e deployleitura e ainda deploy, reversão e reinício
Acesso totaldeploy e ainda variáveis (ler e alterar) e domínios (adicionar, remover)
Acesso total e terminalacesso total e ainda comandos nos seus sites, nos respetivos ficheiros, tarefas cron, chaves SSH e deploys a partir do Git

Também pode definir quando expira — ao fim de 30, 90 ou 365 dias, ou nunca.

  • O token é mostrado uma única vez — copie-o de imediato.
  • Um token age com o seu acesso. Na conta de outra pessoa, age com a sua função na aplicação, e o âmbito do token aplica-se por cima. Consulte Acesso a uma aplicação.
  • Pode ter até 20 tokens. Revogar desativa um token de imediato.
  • Só o próprio pode criar os seus tokens: alguém com sessão iniciada na sua conta em seu nome não pode.

A API REST

A API está documentada em OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importe-a para o Postman, o Insomnia ou um gerador de código.

Endereço base: https://api.rivervo.com/api/v1. Envie o token como bearer token:

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

O que pode fazer:

Método e caminhoO que fazÂmbito
GET /appsas suas aplicações e os respetivos serviçosleitura
GET /apps/{id}uma aplicaçãoleitura
GET /apps/{id}/deploymentsos deploys delaleitura
POST /apps/{id}/deploymentsdeploy: faz o build do commit mais recente ou, com {"rebuild": false}, volta a publicar a versão atualdeploy
GET /apps/{id}/deployments/{deployment}um deploy com o registo do buildleitura
POST /apps/{id}/deployments/{deployment}/rollbackvoltar a essa versãodeploy
POST /apps/{id}/restartreiniciardeploy
GET /apps/{id}/logsregistos de execução do site, de um worker ou do agendamentoleitura
GET, PUT, PATCH /apps/{id}/envler, substituir ou atualizar variáveistotal
GET /apps/{id}/domainsdomíniosleitura
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}adicionar ou remover um domíniototal
  • Conta de outra pessoa: adicione o cabeçalho X-Account: <the account's customer ID> para trabalhar com as aplicações de uma conta a que lhe deram acesso.
  • Limites: 120 pedidos por minuto por pessoa, dos quais 30 alterações. Acima disso, a API responde 429 com Retry-After.
  • Idioma: as mensagens vêm em inglês por predefinição; envie Accept-Language: az ou ru para azerbaijano ou russo.
  • As variáveis alteradas pela API chegam à aplicação no deploy seguinte, tal como no painel — {"rebuild": false} é suficiente.

A linha de comandos rivervo

Deploys, registos, variáveis e reversões a partir do seu terminal, com os mesmos tokens de API. Requer Node.js 22 ou mais recente:

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

Em CI, lê o token da variável RIVERVO_TOKEN, e deploy termina com erro quando a nova versão não fica publicada, por isso pode servir de controlo num pipeline. Até ser publicada, pode fazer o mesmo com a API REST.

«Explicar este erro»

Quando um deploy não termina, ou um serviço deixa de funcionar, aparece Explicar este erro junto ao registo. Lê as últimas linhas do registo e diz-lhe, no seu idioma:

  • Causa provável — o que correu mal;
  • Como corrigir — passos concretos para a sua stack.

A explicação é escrita pela AI a partir do registo; verifique-a antes de alterar o que quer que seja. Antes de qualquer envio, todos os valores das suas variáveis e tudo o que pareça uma chave, palavra-passe ou token são ocultados no registo. O seu código e as suas variáveis nunca são enviados.

Cada pessoa pode pedir até 10 explicações novas por dia; uma explicação já feita para o mesmo registo volta a ser mostrada sem custo.

Rivervo MCP

Também pode trabalhar com as suas aplicações a partir de assistentes de AI através do Rivervo MCP — funciona com o Claude, o ChatGPT, o Cursor, o VS Code e outras aplicações compatíveis com MCP: pergunte sobre deploys, registos e erros numa conversa e deixe o assistente fazer o deploy ou a reversão por si. Não é preciso token; inicia sessão com a sua conta Rivervo. Consulte Rivervo MCP.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte