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.
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:
| Âmbito | Permite |
|---|---|
| Só leitura | aplicações, deploys e respetivos registos, registos de execução, domínios |
| Leitura e deploy | leitura e ainda deploy, reversão e reinício |
| Acesso total | deploy e ainda variáveis (ler e alterar) e domínios (adicionar, remover) |
| Acesso total e terminal | acesso 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/appsO que pode fazer:
| Método e caminho | O que faz | Âmbito |
|---|---|---|
GET /apps | as suas aplicações e os respetivos serviços | leitura |
GET /apps/{id} | uma aplicação | leitura |
GET /apps/{id}/deployments | os deploys dela | leitura |
POST /apps/{id}/deployments | deploy: faz o build do commit mais recente ou, com {"rebuild": false}, volta a publicar a versão atual | deploy |
GET /apps/{id}/deployments/{deployment} | um deploy com o registo do build | leitura |
POST /apps/{id}/deployments/{deployment}/rollback | voltar a essa versão | deploy |
POST /apps/{id}/restart | reiniciar | deploy |
GET /apps/{id}/logs | registos de execução do site, de um worker ou do agendamento | leitura |
GET, PUT, PATCH /apps/{id}/env | ler, substituir ou atualizar variáveis | total |
GET /apps/{id}/domains | domínios | leitura |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | adicionar ou remover um domínio | total |
- 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
429comRetry-After. - Idioma: as mensagens vêm em inglês por predefinição; envie
Accept-Language: azourupara 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 versionEm 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.