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. |
invalid_ooh_format. Marca inexistente no workspace responde brand_not_found.
Exemplo
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" }
}'
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
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
202 com o pré-teste em queued e o cabeçalho Location. Siga com a consulta do status e a leitura do resultado.