API REST
Tudo o que você faz no painel também roda pela API REST, na base https://api.w8hub.com.br/v1 — ideal para CI/CD, automações e agentes de IA. São mais de 170 endpoints cobrindo projetos, instalações, deploys, bancos, domínios, integrações, observabilidade e time.
Autenticação
Crie um token de API na organização e envie no header Authorization. Exemplo — listar suas instalações:
curl https://api.w8hub.com.br/v1/resources/ \
-H "Authorization: Bearer w8_seu_token_aqui"Exemplos comuns
Disparar um deploy de uma instalação:
curl -X POST https://api.w8hub.com.br/v1/resources/{id}/deployments/ \
-H "Authorization: Bearer w8_seu_token_aqui"Criar uma instalação a partir de um repositório GitHub público, buildando com Nixpacks (sem Dockerfile):
curl -X POST https://api.w8hub.com.br/v1/resources/public-github \
-H "Authorization: Bearer w8_seu_token_aqui" \
-H "Content-Type: application/json" \
-d '{
"projectId": "proj_123",
"name": "minha-api",
"gitRepository": "https://github.com/acme/minha-api",
"gitBranch": "main",
"buildMode": "nixpacks",
"generateDomain": true,
"instantDeploy": true
}'Áreas da API
Os endpoints seguem as mesmas áreas do painel:
| Área | Base do endpoint |
|---|---|
| Projetos | /v1/projects |
| Instalações | /v1/resources |
| Deploys | /v1/resources/{id}/deployments |
| Variáveis de ambiente | /v1/resources/{id}/envs |
| Logs | /v1/resources/{id}/logs |
| Proxy | /v1/resources/{id}/proxy |
| Bancos de dados | /v1/databases |
| Domínios | /v1/domains |
| Armazenamento S3 | /v1/storage/buckets |
| Integrações | /v1/organizations/{orgId}/integrations |
| Webhooks | /v1/organizations/{orgId}/webhooks |
| Tokens de API | /v1/api-tokens/{orgId} |
| Observabilidade | /v1/monitoring, /v1/alerts, /v1/organizations/{orgId}/incidents |
| Time e organização | /v1/organizations |
A referência interativa completa (todos os endpoints, campos e respostas) está abaixo: