> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myunite.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Resultados

> Como ler status, nota, pilares, achados e PDF de um pré-teste.

Consulte um pré-teste com `GET /pretests/{id}`.

## Status

| Status | Significa |
| - | - |
| `queued` | Aceito e esperando para começar. |
| `processing` | Em análise. |
| `completed` | Resultado disponível em `result`. |
| `failed` | Não foi concluído. Veja `error`. |

`result` só vem preenchido quando o status é `completed`. `error` só vem quando é `failed`.

## Nota e recomendação

* `result.score`: nota geral de 0 a 10. Pode ser `null`.
* `result.recommendation`: `launch`, `optimize` ou `iterate`, do mais favorável ao que pede mais trabalho. Pode ser `null`.
* `result.recommendationLabel`: o mesmo texto, pronto para exibir, no idioma do resultado.
* `result.conclusion`: parágrafo de conclusão.

## Pilares

`result.pillars` é um objeto com uma nota de 0 a 10 por pilar de avaliação. Os pilares variam conforme o canal, então leia as chaves que vierem em vez de assumir uma lista fixa.

## Achados

`result.findings` lista as verificações feitas na peça. Cada item tem:

| Campo | Descrição |
| - | - |
| `check` | Identificador estável da verificação. |
| `name` | Nome para exibir. |
| `category` | Grupo da verificação. |
| `status` | `pass`, `warn`, `fail`, `info` ou `pending`. |
| `score` | Nota de 0 a 10, ou `null`. |
| `summary` | Explicação curta, ou `null`. |
| `optional` | `true` se a verificação é opcional. |

## Recomendações e mapas

* `result.recommendations`: ações sugeridas, cada uma com `title`, `description`, `priority` (`high`, `medium` ou `low`) e `category`.
* `result.maps`: `heatmap`, `contrast` e `focus`, cada um `null` ou com `url` e `mediaType` (`image/jpeg` ou `video/mp4`).

## PDF da análise

`report.status` do pré-teste mostra o estado do PDF: `pending`, `generating`, `ready`, `failed` ou `unavailable`. Ele fica `pending` até o PDF ser gerado. Em OOH e digital, o PDF costuma ser gerado sozinho depois que a análise termina. Em e-mail, só é gerado quando você o pede. `GET /pretests/{id}/report` inicia a geração de qualquer pré-teste `completed` e devolve o link quando estiver pronto:

| Resposta | O que fazer |
| - | - |
| `200` com `status: "ready"` | Baixe o PDF em `url`. Busque o link quando precisar do arquivo e não conte com a URL continuar a mesma. |
| `202` com `status: "generating"` | Espere o tempo de `Retry-After` e consulte de novo. |
| `409` [`report_not_ready`](https://docs.myunite.ai/errors#report_not_ready) | O pré-teste ainda não está `completed`. |

```bash curl theme={null}
curl https://myunite.ai/api/v1/pretests/ID_DO_PRETESTE \
  -H "Authorization: Bearer $UNITE_API_KEY"
```

```javascript JavaScript theme={null}
const res = await fetch("https://myunite.ai/api/v1/pretests/ID_DO_PRETESTE", {
  headers: { Authorization: `Bearer ${process.env.UNITE_API_KEY}` },
});
const p = await res.json();
if (p.status === "completed") {
  console.log(p.result.score, p.result.recommendationLabel);
  for (const f of p.result.findings.filter((f) => f.status === "fail")) {
    console.log(f.name, f.summary);
  }
} else if (p.status === "failed") {
  console.log("Falhou:", p.error.code);
}
```

```python Python theme={null}
import os
import requests

p = requests.get(
    "https://myunite.ai/api/v1/pretests/ID_DO_PRETESTE",
    headers={"Authorization": f"Bearer {os.environ['UNITE_API_KEY']}"},
).json()
if p["status"] == "completed":
    print(p["result"]["score"], p["result"]["recommendationLabel"])
    for f in p["result"]["findings"]:
        if f["status"] == "fail":
            print(f["name"], f["summary"])
elif p["status"] == "failed":
    print("Falhou:", p["error"]["code"])
```

## Quando falha

Um pré-teste `failed` traz `error.code`:

| Código | Significado |
| - | - |
| `video_too_long` | O vídeo passa de 30 segundos. |
| `quota_exhausted` | A cota de pré-testes acabou. |
| `dispatch_failed` | A análise não pôde ser iniciada. Se ficar parada antes de começar por 2 horas, o pré-teste falha com este código e a unidade da cota é devolvida. |
| `processing_failed` | A análise não pôde ser concluída. |

Esses códigos aparecem em `error.code` do pré-teste. Os erros de chamada (HTTP 4xx e 5xx) estão em [Erros](https://docs.myunite.ai/errors.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.