---
title: "Arc Deeplink"
method: GET
path: "/api/v1/arc/deeplink"
tags: ["arco"]
---

# Arc Deeplink

`GET /api/v1/arc/deeplink`

## 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/deeplink`
- Auth: none declared

Traduz a URL do CTA da IA no conjunto que a tela deve semear, pelo MESMO
`calc_core.parse_deeplink` que a sidebar do app usa — a vitrine consome o
veredito, não reimplementa o gate.

Os parâmetros entram como TEXTO de propósito: quem decide o que é número é o
núcleo, e um valor podre tem de derrubar o conjunto inteiro com uma resposta
limpa (`semeado=false`), não virar 422 da casca. Sem cálculo e sem dado do
usuário aqui, então sem teto — é um validador, como o catálogo de ferramentas.

## Query parameters

- `voc` string, nullable
- `ibf` string, nullable
- `gap` string, nullable
- `d` string, nullable
- `tp` string, nullable
- `tr` string, nullable
- `cfg` string, nullable
- `w` string, nullable
- `h` string, nullable
- `p` string, nullable

## Response `200`

Successful Response

- DeeplinkOut: O handoff de estado do CTA (IA → tela) já passado pelo gate do NÚCLEO (`calc_core.parse_deeplink`). Existe para que a vitrine /v2 não reimplemente a validação em TypeScript: a URL é input hostil e a regra é semear o conjunto INTEIRO ou nada — semear metade poria na tela um Ei diferente do que a IA mostrou. `semeado=False` é resposta legítima, não erro: ou a URL não trazia cálculo, ou o conjunto foi recusado. `parcial=True` é o handoff do CURTO, que conhece a falta mas não o painel: o trio gap/D/tempo NÃO vem, os campos ficam nulos (a tela mantém o próprio valor) e a UI tem de pedir a conferência.
  - `semeado` boolean, required
  - `parcial` boolean: handoff do curto: o trio do equipamento não veio
  - `Voc` number, nullable
  - `Ibf` number, nullable
  - `G` number, nullable
  - `D` number, nullable
  - `T_p` number, nullable
  - `T_r` number, nullable
  - `cfg` string, nullable
  - `W` number, nullable
  - `H` number, nullable
  - `P` number, nullable
  - `motivo` string: por que não houve semeadura

## Other responses

- `422`: Validation Error

---

[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)