Casa das Impressoras

Visão geral

O Servidor de Impressão roda na máquina Windows onde a impressora está instalada. Ele abre uma conexão de saída com o Gestor Mãe (servidor da Casa das Impressoras). Assim, mesmo que o IP da rede do cliente mude, sistemas na internet usam sempre a URL pública única da estação.

Sistema (web/legado)  →  Gestor Mãe (URL pública)  →  Agente local  →  Impressora

URL única de impressão

Cada estação recebe um endereço estável:

POST {PUBLIC_BASE}/v1/p/{publicId}

Exemplo:

POST https://impressao.seudominio.com.br/v1/p/cdi_a1b2c3d4e5f60718
Header: X-Api-Key: <chave>
Content-Type: application/json

{
  "titulo": "Etiqueta DS 123",
  "payloadTipo": "png",
  "payloadBase64": "<PNG em Base64>",
  "larguraMm": 33,
  "alturaMm": 22,
  "copias": 1,
  "impressora": "Zebra TLP2840"   // opcional
}

Resposta 202: job enfileirado no Mãe; o agente busca e imprime na LAN.

Autenticação

• X-Api-Key (ou Bearer) = chave master do Gestor Mãe ou
• X-Estacao-Key = chave local da estação (a mesma do agente)

Consultar status

GET /v1/p/{publicId}/status/{jobId}

Monitor (admin / localhost)

Painel web: http://…:9200/ — instalados, ativos, caminhos LAN/públicos, filas, impressoras e documentos impressos.

GET /v1/dashboard
GET /v1/config
POST /v1/config

No Visual Studio: solução Util.GestorServidoresImpressao.sln → Host com ícone na bandeja.

Listar estações (admin)

GET /v1/stations
Header: X-Api-Key: <master>

Retorna online/offline, IPs LAN atuais, filas/impressoras e a URL pública de cada uma.

API local do agente (mesma rede)

Na LAN do cliente ainda funciona a API direta do servidor instalado (porta 9108), documentada em Util.ServidorDeImpressao/docs/API.md. Use a URL pública do Mãe para sistemas na internet.

Exemplo cURL

curl -X POST "https://SEU_GESTOR/v1/p/cdi_XXXX" ^
  -H "X-Api-Key: SUA_CHAVE" ^
  -H "Content-Type: application/json" ^
  -d "{\"titulo\":\"teste\",\"payloadBase64\":\"iVBORw0KGgo...\",\"larguraMm\":33,\"alturaMm\":22}"