Tema
Nodes
Cada instalação local é um node registrado, com credencial própria. O segredo é gerado, guardado como hash e mostrado uma única vez no registro/rotação.
| Método | Rota | Auth | Descrição |
|---|---|---|---|
| POST | /api/admin/nodes/register | nodes:manage | registra um node (devolve o segredo 1x) |
| GET | /api/admin/nodes?companyId= | nodes:read | lista nodes de uma empresa |
| GET | /api/admin/nodes/:id/status | nodes:read | status do node |
| POST | /api/admin/nodes/:id/activate | nodes:manage | ativa o node |
| POST | /api/admin/nodes/:id/deactivate | nodes:manage | desativa o node |
| POST | /api/admin/nodes/:id/rotate-secret | nodes:manage | gera um novo segredo (devolve 1x) |
| POST | /api/admin/nodes/validate | credencial node | valida as credenciais do node (Sync Worker) |
Registrar
bash
curl -X POST $BASE/api/admin/nodes/register \
-H "authorization: Bearer <token>" -H 'content-type: application/json' \
-d '{ "companyId": "<uuid>", "name": "recepcao-01" }'json
{ "node": { "id": "<NODE_ID>", "status": "pending" }, "secret": "<NODE_SECRET — guarde, é mostrado uma vez>" }O NODE_ID e o NODE_SECRET vão no .env da instalação local. O Sync Worker os envia nos headers X-Node-Id / X-Node-Secret ao falar com a nuvem.