Começar

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

Crie tokens de API com o escopo certo, trabalhe com aplicativos a partir de scripts e de CI pela API REST e pela linha de comando rivervo, e receba explicações da AI sobre deploys que falharam.

4 MIN DE LEITURA

Tudo o que você faz com aplicativos no painel também pode ser automatizado — deploys a partir do CI, variáveis por script, logs no seu terminal.

Tokens de API

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

EscopoPermite
Somente leituraaplicativos, deploys e seus logs, logs de execução, domínios
Leitura e deployleitura, mais deploy, rollback e reinicialização
Acesso totaldeploy, mais variáveis (ler e alterar) e domínios (adicionar, remover)
Acesso total e terminalacesso total, mais comandos nos seus sites, nos arquivos deles, tarefas cron, chaves SSH e deploys a partir do Git

Você também pode definir quando ele expira — depois de 30, 90 ou 365 dias, ou nunca.

  • O token aparece uma única vez — copie-o na hora.
  • Um token age com o seu acesso. Na conta de outra pessoa, ele age com o seu papel no aplicativo, e o escopo do token se aplica por cima disso. Veja Acesso a um aplicativo.
  • Você pode ter até 20 tokens. Revogar desativa um token na hora.
  • Só você pode criar seus tokens: alguém que entrou na sua conta em seu nome não pode.

A API REST

A API é documentada em OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Importe-a no Postman, no Insomnia ou em 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 você pode fazer:

Método e caminhoO que fazEscopo
GET /appsseus aplicativos e os serviços delesleitura
GET /apps/{id}um aplicativoleitura
GET /apps/{id}/deploymentsos deploys deleleitura
POST /apps/{id}/deploymentsdeploy: faz o build do último commit ou, com {"rebuild": false}, faz o deploy da versão atual de novodeploy
GET /apps/{id}/deployments/{deployment}um deploy com o log de buildleitura
POST /apps/{id}/deployments/{deployment}/rollbackvolta para essa versãodeploy
POST /apps/{id}/restartreiniciadeploy
GET /apps/{id}/logslogs de execução do site, de um worker ou das tarefas agendadasleitura
GET, PUT, PATCH /apps/{id}/envlê, substitui ou atualiza variáveistotal
GET /apps/{id}/domainsdomíniosleitura
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}adiciona ou remove um domíniototal
  • Conta de outra pessoa: adicione o cabeçalho X-Account: <the account's customer ID> para trabalhar com os aplicativos de uma conta à qual você recebeu acesso.
  • Limites: 120 requisições por minuto por pessoa, das quais 30 alterações. Acima disso, a API responde 429 com Retry-After.
  • Idioma: por padrão, as mensagens vêm em inglês; envie Accept-Language: az ou ru para azerbaijano ou russo.
  • Variáveis alteradas pela API chegam ao aplicativo no próximo deploy, como no painel — {"rebuild": false} basta.

A linha de comando rivervo

Deploys, logs, variáveis e rollbacks pelo terminal, com os mesmos tokens de API. Ela precisa do 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

No CI, ela lê o token da variável RIVERVO_TOKEN, e o deploy termina com erro quando a nova versão não entra no ar, então ele pode servir de etapa de controle em um pipeline. Até ela ser publicada, o mesmo pode ser feito com a API REST.

«Explicar este erro»

Quando um deploy não termina ou um serviço para de funcionar, Explicar este erro aparece ao lado do log. Ele lê as últimas linhas do log e diz, no seu idioma:

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

A explicação é escrita pela AI a partir do log; confira-a antes de mudar qualquer coisa. Antes de qualquer envio, todos os valores das suas variáveis e tudo o que parece uma chave, senha ou token são ocultados do log. Seu código e as próprias 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 log é mostrada de novo sem custo.

Rivervo MCP

Você também pode trabalhar com seus aplicativos a partir de assistentes de AI pelo Rivervo MCP — ele funciona com Claude, ChatGPT, Cursor, VS Code e outros apps compatíveis com MCP: pergunte sobre deploys, logs e erros em uma conversa e deixe o assistente fazer o deploy ou o rollback por você. Não é preciso token; você entra com a sua conta Rivervo. Veja Rivervo MCP.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte