> ## 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.

# Pré-teste OOH

> Crie um pré-teste de mídia exterior.

Use `channel: "ooh"` para peças de mídia exterior (painéis, empenas, mobiliário urbano e similares).

## Campos

| Campo | Obrigatório | Descrição |
| - | - | - |
| `uploadId` | Sim | Id devolvido por `POST /uploads`, depois de enviar o arquivo. Imagem ou vídeo de até 30 s. |
| `channel` | Sim | `ooh`. |
| `ooh.format` | Sim | O `key` de um formato em `GET /catalog`, em `ooh.formats`. |
| `title` | Não | Nome do pré-teste (até 200 caracteres). Sem ele, a Unite gera um. |
| `brandId` | Não | Id de uma marca em `GET /catalog`. Ativa as verificações de marca. |
| `locale` | Não | `pt`, `en` ou `es`: idioma dos textos do resultado. Sem ele, vale o `Accept-Language` e, depois, `pt`. |
| `metadata` | Não | Até 20 pares chave e valor de texto (chave até 40 caracteres, valor até 500). Volta no pré-teste. |

Formato desconhecido responde [`invalid_ooh_format`](https://docs.myunite.ai/errors#invalid_ooh_format). Marca inexistente no workspace responde [`brand_not_found`](https://docs.myunite.ai/errors#brand_not_found).

## Exemplo

```bash curl theme={null}
curl -X POST https://myunite.ai/api/v1/pretests \
  -H "Authorization: Bearer $UNITE_API_KEY" \
  -H "Idempotency-Key: verao-relogio-urbano-ooh-001" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadId": "upl_0123456789abcdef0123456789abcdef.png",
    "title": "Verão · relógio urbano",
    "channel": "ooh",
    "ooh": { "format": "FORMATO_DO_CATALOGO" },
    "brandId": "ID_DA_MARCA",
    "metadata": { "campanha": "verao-2027" }
  }'
```

```javascript JavaScript theme={null}
const res = await fetch("https://myunite.ai/api/v1/pretests", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UNITE_API_KEY}`,
    "Idempotency-Key": "verao-relogio-urbano-ooh-001",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    uploadId: "upl_0123456789abcdef0123456789abcdef.png",
    title: "Verão · relógio urbano",
    channel: "ooh",
    ooh: { format: "FORMATO_DO_CATALOGO" },
    brandId: "ID_DA_MARCA",
    metadata: { campanha: "verao-2027" },
  }),
});
console.log(res.status, await res.json()); // 202
```

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

res = requests.post(
    "https://myunite.ai/api/v1/pretests",
    headers={
        "Authorization": f"Bearer {os.environ['UNITE_API_KEY']}",
        "Idempotency-Key": "verao-relogio-urbano-ooh-001",
    },
    json={
        "uploadId": "upl_0123456789abcdef0123456789abcdef.png",
        "title": "Verão · relógio urbano",
        "channel": "ooh",
        "ooh": {"format": "FORMATO_DO_CATALOGO"},
        "brandId": "ID_DA_MARCA",
        "metadata": {"campanha": "verao-2027"},
    },
)
print(res.status_code, res.json())  # 202
```

A resposta é `202` com o pré-teste em `queued` e o cabeçalho `Location`. Siga com a [consulta do status](https://docs.myunite.ai/quickstart.md) e a leitura do [resultado](https://docs.myunite.ai/results.md).


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