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.
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:
| Escopo | Permite |
|---|---|
| Somente leitura | aplicativos, deploys e seus logs, logs de execução, domínios |
| Leitura e deploy | leitura, mais deploy, rollback e reinicialização |
| Acesso total | deploy, mais variáveis (ler e alterar) e domínios (adicionar, remover) |
| Acesso total e terminal | acesso 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/appsO que você pode fazer:
| Método e caminho | O que faz | Escopo |
|---|---|---|
GET /apps | seus aplicativos e os serviços deles | leitura |
GET /apps/{id} | um aplicativo | leitura |
GET /apps/{id}/deployments | os deploys dele | leitura |
POST /apps/{id}/deployments | deploy: faz o build do último commit ou, com {"rebuild": false}, faz o deploy da versão atual de novo | deploy |
GET /apps/{id}/deployments/{deployment} | um deploy com o log de build | leitura |
POST /apps/{id}/deployments/{deployment}/rollback | volta para essa versão | deploy |
POST /apps/{id}/restart | reinicia | deploy |
GET /apps/{id}/logs | logs de execução do site, de um worker ou das tarefas agendadas | leitura |
GET, PUT, PATCH /apps/{id}/env | lê, substitui ou atualiza variáveis | total |
GET /apps/{id}/domains | domínios | leitura |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | adiciona ou remove um domínio | total |
- 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
429comRetry-After. - Idioma: por padrão, as mensagens vêm em inglês; envie
Accept-Language: azourupara 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 versionNo 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.