Endpoints de Cálculo — Referência da API

Referência completa de todos os endpoints REST API de cálculo: parâmetros de requisição, formato de resposta e exemplos para cada tipo de serpentina.

1. Estrutura Comum de Requisição

Todos os endpoints de cálculo aceitam uma requisição POST com corpo JSON. O corpo é estruturado em seções:

air: Condições do lado do ar (temperatura, umidade, vazão)
fluid / refrigerant: Condições do lado do fluido/refrigerante
geometry: Dimensões físicas e construção da serpentina
options: Opções do solver (modo, fator de má distribuição, etc.)

2. Serpentina de Água Gelada

POST /api/v1/calculate/chilled-water

{ "air": { "T_db": 27, "T_wb": 19, "airFlow_m3h": 10000, "altitude_m": 0 }, "fluid": { "type": "water", "T_in": 7, "T_out": 12, "flowRate_kgh": 8600 }, "geometry": { "tubeOD_mm": 9.52, "tubeThk_mm": 0.35, "finPitch_fpi": 12, "finThk_mm": 0.1, "Pt_mm": 25.4, "Pl_mm": 22, "rows": 4, "tubesPerRow": 24, "circuits": 8, "finLength_mm": 1200 } }

A resposta inclui capacidade total (kW), divisão sensível/latente, SHR, condições do ar de saída, perdas de carga no lado do ar e do fluido, e valor UA.

3. Serpentina de Água Quente

POST /api/v1/calculate/hot-water

Mesma estrutura da água gelada, mas com temperaturas de água quente (tipicamente T_in: 60–90°C, T_out: 40–70°C). O cálculo do lado do ar é apenas sensível (sem desumidificação).

4. Serpentina a Vapor

POST /api/v1/calculate/steam-coil

{ "air": { "T_db": 15, "airFlow_m3h": 5000, "altitude_m": 0 }, "steam": { "pressure_kPa": 100, "quality": 1.0 }, "geometry": { ... } }

A seção steam substitui a seção fluid. A resposta inclui capacidade de aquecimento, taxa de condensado (kg/h) e temperatura do ar de saída.

5. Dry Cooler

POST /api/v1/calculate/dry-cooler

Similar à água quente mas para rejeição de calor. A seção fluid suporta misturas de glicol:

"fluid": { "type": "ethylene_glycol", "concentration": 30, "T_in": 40, "T_out": 35, "flowRate_kgh": 15000 }

6. Evaporador DX

POST /api/v1/calculate/dx-evaporator

POST /api/v1/calculate/dx-evaporator/balanced

{ "air": { "T_db": 27, "T_wb": 19, "airFlow_m3h": 8000, "altitude_m": 0 }, "refrigerant": { "type": "R410A", "T_evap": 7, "superheat_K": 8, "inletQuality": 0.22, "massFlow_kgh": 500 }, "geometry": { ... } }

O endpoint /balanced encontra automaticamente a vazão mássica que fecha o balanço energético (Q_ar = Q_ref). O endpoint padrão usa a vazão mássica fornecida.

7. Condensador DX

POST /api/v1/calculate/dx-condenser

POST /api/v1/calculate/dx-condenser/balanced

"refrigerant": { "type": "R410A", "T_cond": 45, "subcooling_K": 5, "dischargeSH_K": 40, "massFlow_kgh": 600 }

A resposta inclui detalhamento por zona (capacidades de desuperaquecimento, condensação, sub-resfriamento), rejeição total de calor e status do condensador.

8. Lista de Refrigerantes

GET /api/v1/refrigerants

Retorna a lista de refrigerantes suportados com propriedades (GWP, ODP, classe de segurança, temperatura crítica, pressão crítica). Nenhum corpo de requisição necessário.

Todos os endpoints de cálculo requerem a permissão calc:read. O endpoint de refrigerantes também está disponível com calc:read.

9. Campos Comuns de Resposta

Campo	Tipo	Descrição
totalCapacity_kW	number	Capacidade total de transferência de calor
sensibleCapacity_kW	number	Capacidade sensível (apenas serpentinas de resfriamento)
latentCapacity_kW	number	Capacidade latente (apenas serpentinas de resfriamento)
airPressureDrop_Pa	number	Perda de carga no lado do ar
fluidPressureDrop_kPa	number	Perda de carga no lado do fluido/refrigerante
leavingAir	object	Condições do ar de saída (T_db, T_wb, UR)
coilCode	string	Código de identificação da serpentina gerado