W8 Hub para a IA do cliente: opere a conta pela API

A W8 Hub é uma plataforma de infraestrutura de software gerenciada no Brasil. O cliente publica aplicações em container (Docker) e a W8 Hub cuida de deploy, banco de dados, domínios, SSL, backups e observabilidade.

Se você é um assistente de IA conectado à conta de um cliente W8 Hub, para fazer qualquer coisa (listar projetos, fazer deploy, alterar variáveis, reiniciar serviços, gerenciar bancos e domínios, ler logs) você deve usar a API REST. Não há outra forma programática — tudo passa pela API.

1. Como obter o token de API

A API exige autenticação por token, gerado pelo próprio cliente no painel:

1. Acesse o painel da W8 Hub em dev.w8hub.com.br.
2. Vá até a página da organização e abra a rota /token.
3. Clique em "Novo Token de API", dê um nome (ex.: "Integração IA"), opcionalmente restrinja as origens permitidas (IPs ou domínios) e defina a expiração.
4. Clique em "Criar Token" e copie o valor (ele só aparece uma vez).

Atenção: por enquanto o token não vem habilitado automaticamente. Após criá-lo, é preciso solicitar a habilitação ao suporte da W8 Hub. Enquanto isso não for feito, toda chamada retorna 403 AUDIENCE_MISMATCH — mesmo que o token e o header Authorization estejam corretos. Se receber esse erro, verifique se a habilitação já foi solicitada e concluída.

Peça esse token ao cliente e envie em toda chamada no header Authorization, no formato Bearer:

Authorization: Bearer SEU_TOKEN

Trate o token como segredo: guarde em variável de ambiente (ex.: W8_TOKEN), nunca imprima em logs nem exponha ao usuário final.

2. Como a conta é organizada: Organização → Projeto → Recurso

Entenda a hierarquia antes de chamar a API. Quase toda chamada precisa de escopo.

Fluxo típico: descubra a organização → liste os projetos dela → liste/aja nos recursos do projeto. Passe orgId e/ou projectId como query params para filtrar.

3. Fluxo básico (exemplos com curl)

# defina o token uma vez
export W8_TOKEN="cole_o_token_aqui"

# 3.1 descobrir a organização do cliente
curl https://api.w8hub.com.br/v1/organizations/ \
  -H "Authorization: Bearer $W8_TOKEN"

# 3.2 listar os projetos de uma organização
curl "https://api.w8hub.com.br/v1/projects/?orgId=ORG_ID" \
  -H "Authorization: Bearer $W8_TOKEN"

# 3.3 listar os recursos (apps) de um projeto
curl "https://api.w8hub.com.br/v1/resources/?projectId=PROJECT_ID&orgId=ORG_ID" \
  -H "Authorization: Bearer $W8_TOKEN"

# 3.4 disparar um deploy do recurso
curl -X POST https://api.w8hub.com.br/v1/resources/RESOURCE_ID/deployments/ \
  -H "Authorization: Bearer $W8_TOKEN" -H "Content-Type: application/json" \
  -d '{"force": true}'

# 3.5 criar uma variável de ambiente (key e value obrigatórios)
curl -X POST https://api.w8hub.com.br/v1/resources/RESOURCE_ID/envs \
  -H "Authorization: Bearer $W8_TOKEN" -H "Content-Type: application/json" \
  -d '{"key":"DATABASE_URL","value":"postgres://..."}'

# 3.6 reiniciar / parar / iniciar um recurso
curl -X POST https://api.w8hub.com.br/v1/resources/RESOURCE_ID/restart \
  -H "Authorization: Bearer $W8_TOKEN"   # idem /stop e /start

# 3.7 ler logs e métricas
curl https://api.w8hub.com.br/v1/monitoring/resources/RESOURCE_ID/logs \
  -H "Authorization: Bearer $W8_TOKEN"
curl https://api.w8hub.com.br/v1/monitoring/resources/RESOURCE_ID/metrics \
  -H "Authorization: Bearer $W8_TOKEN"

4. O que dá pra fazer pela API

• Organizações: GET /v1/organizations/; GET, PATCH /v1/organizations/{id}
• Projetos: GET /v1/projects/?orgId=...
• Recursos: GET /v1/resources/?projectId=...&orgId=...; GET, PATCH, DELETE /v1/resources/{id}; start/stop/restart; deploys (GET/POST /v1/resources/{id}/deployments/); variáveis de ambiente (/envs, CRUD + /envs/bulk); domínio do recurso (PATCH /v1/resources/{id}/domain)
• Bancos de dados: GET /v1/databases/?projectId=...; GET /v1/databases/{id}; start/stop/restart
• Domínios: GET, POST /v1/domains/; GET, PATCH, DELETE /v1/domains/{id}; attach/detach/verify/set-primary
• Monitoramento: /v1/monitoring/resources/{id}/ metrics, logs, logs/volume, containers
• Logs de auditoria: GET /v1/audit-logs/

Sempre confira o contrato exato (campos, filtros, formatos de resposta) na documentação da API antes de assumir um payload.

5. Sobre a W8 Hub (contexto)

Infraestrutura de software gerenciada no Brasil. Suba seu Docker em minutos e escale de 10 a 10.000 usuários sem contratar um time de DevOps. Scaling transparente: começa simples e escala por addons (alta disponibilidade, multi-região, multi-cloud, compliance) com 1 clique, sem migrar, sem reescrever e sem lock-in. Preço em reais (sem dólar/IOF), dados no Brasil com LGPD e suporte em português. Planos: gratuito (R$ 0), Startup (R$ 49,90/mês de uso mínimo) e Enterprise (sob consulta).

Painel: dev.w8hub.com.br · Site: w8hub.com.br · Planos: /precos · Demo: /demo · Visão geral para LLMs: /llms.txt