Skip to content

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étodoRotaAuthDescrição
POST/api/admin/nodes/registernodes:manageregistra um node (devolve o segredo 1x)
GET/api/admin/nodes?companyId=nodes:readlista nodes de uma empresa
GET/api/admin/nodes/:id/statusnodes:readstatus do node
POST/api/admin/nodes/:id/activatenodes:manageativa o node
POST/api/admin/nodes/:id/deactivatenodes:managedesativa o node
POST/api/admin/nodes/:id/rotate-secretnodes:managegera um novo segredo (devolve 1x)
POST/api/admin/nodes/validatecredencial nodevalida 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.