---
title: "Arc Hv"
method: POST
path: "/api/v1/arc/hv"
tags: ["arco"]
---

# Arc Hv

`POST /api/v1/arc/hv`

## Request

- Base URL: `https://app.estudoseletricos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.estudoseletricos.com/api/v1/arc/hv`
- Auth: none declared

A triagem acima de 15 kV pelos três métodos publicados.

Não há um 'melhor' entre eles e a rota não escolhe: a OSHA dá a BANDA
conservadora que a norma de trabalho usa, o Lee dá a cota teórica (que
acima de 15 kV superestima muito, e o próprio resultado diz isso), e o EPRI
é o único ajustado em ensaio para arco ao ar livre — com a faixa
certificada declarada e o aviso de extrapolação quando se sai dela.

## Request body

- HvRequest: Entrada da triagem > 15 kV (arco ao ar livre fase-terra). Três métodos com exigências DIFERENTES, e o contrato não as achata: Lee precisa de `D`, o EPRI precisa de `D` e de `G_m`, e a OSHA de nenhum dos dois (a tabela já embute a distância). Pedir tudo de todos obrigaria o usuário a inventar um número que o método dele não usa.
  - `metodo` 'osha' | 'lee' | 'epri'
  - `Voc` number, required: tensão de operação (kV) — o modo existe acima de 15 kV
  - `Ibf` number, required: corrente de falta franca FASE-TERRA (kA)
  - `T_p` number, required: tempo de eliminação (ms)
  - `D` number, nullable: distância de trabalho (mm) — exigida por Lee e EPRI; na OSHA a tabela já a fixa
  - `G_m` number, nullable: comprimento de arco em METROS (vão físico fase-terra) — exigido pelo EPRI; NÃO é o gap do IEEE 1584
  - `trabalho` 'luva' | 'vara': OSHA: 'luva' = Tabela 6 (4–46 kV, 380 mm) · 'vara' = Tabela 7 (4–800 kV)
  - `lang` string

## Response `200`

Successful Response

- HvOut: O resultado da triagem. Cada método preenche os campos DELE e deixa os outros nulos — um Eave de método que não calcula Eave seria invenção. `Ei_cal` NULO com `excede_tabela=True` é o caso mais delicado: na OSHA, o tempo acima da última coluna significa energia ACIMA de 12 cal/cm², e não energia desconhecida. Escrever 12 ali seria subestimar; escrever um número grande seria inventar. O par (nulo + a banda '> 12') é o que a tabela realmente diz — e é por isso que `categoria` e `epi` também ficam vazios: a NBR não mapeia banda que a tabela não fecha.
  - `metodo` 'osha' | 'lee' | 'epri', required
  - `Ei_cal` number, nullable: energia de triagem (cal/cm²); NULA quando a tabela é excedida — ver `excede_tabela`
  - `excede_tabela` boolean: OSHA: o tempo passou da última coluna (> 12 cal/cm²)
  - `banda_label` string, nullable: '≤ 4' … '> 12' (cal/cm²)
  - `banda_cal` number, nullable: cabeçalho da coluna (cal/cm²)
  - `Ei_interp_cal` number, nullable: estimativa interpolada no tempo — NÃO normativa
  - `bloco` string, nullable: faixa de tensão da tabela
  - `linha_kA` number, nullable: linha da tabela (round-up)
  - `t_ciclos` number, nullable
  - `trabalho` string, nullable
  - `DB_mm` number, nullable: fronteira de 1,2 cal/cm² (mm)
  - `Ei_J` number, nullable
  - `Eave_kVm` number, nullable
  - `Varc_kV` number, nullable
  - `Phi_cal_s` number, nullable: fluxo de energia (cal/cm²·s)
  - `W_cal` number, nullable: energia MÉDIA (cal/cm²)
  - `Wmax_cal` number, nullable: W × fator estatístico k
  - `k_stat` number, nullable
  - `G_m` number, nullable
  - `D_assumida_mm` number, nullable: distância a que a energia se refere; NULA na Tabela 7 da OSHA, que não fixa uma
  - `categoria` Categoria
    - `n` integer, required: 1 = abaixo do LAS · 2 = Tab. 11 · 3 = Tab. 12 · 5 = proibido
    - `label` string, required
    - `faixa` string, required
  - `epi` string[]
  - `avisos_faixa` string[]: EPRI: extrapolação fora da faixa certificada em ensaio (Tabela 3)
  - `escopo` string, required: a ressalva de escopo — este resultado é TRIAGEM, não laudo
  - `engine` string
  - `tier` string

## Other responses

- `422`: fora do domínio da triagem (erros nomeados)

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)