O inventário ÚNICO de públicos do cliente

GET

/v1/t/{tenantID}/publicos

curl --request GET \
  --url https://dash.owiew.com/v1/t/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/publicos \
  --header 'Authorization: Bearer <token>'

• Produção

Todos os públicos, das duas origens misturadas: os montado (um briefing respondido em quatro passos) e os semelhante (uma lista de clientes importada). Separá-los em duas listas reconstruiria as duas áreas que a unificação desfez — do lado de quem usa, as duas produzem a mesma coisa: um público para levar ao Gerenciador.

A proposta NÃO vem aqui — nem o recorte, nem o ranking de redes, nem os termos, nem o relatório de qualidade. Cada linha traz um resumo PARCIAL, com o que aquela origem tem de próprio, e campo ausente é ausente: um montado não traz aproveitadas, e ele não vem como zero.

Exige a permissão publico.read.

Authorizations

• tokenDeAcesso

Parameters

Path Parameters

tenantID

required

string format: uuid

O cliente. Vem SEMPRE do caminho — nunca de cabeçalho, nunca de cookie. Ele é conferido contra o token: um identificador que não bata com o do token devolve 403, e não uma resposta vazia.

Responses

200

OK

Media typeapplication/json

object

publicos

Array<object>

Um público na listagem. A rota devolve as DUAS origens misturadas, em ordem única — separá-las em duas listas reconstruiria as duas áreas que a unificação desfez.

object

id

string format: uuid

nome

string

origem

string

Allowed values: montado semelhante

criado_em

string format: date-time

resumo

O que aquela origem tem de próprio para caber numa linha. Todo campo é opcional, e a ausência é informação.

object

ticket

A faixa (t1–t6), só em montado.

string

mercado

Só em montado.

string

aproveitadas

Linhas que viraram contato único, só em semelhante. NÃO É ALCANCE — quantas a plataforma casa com gente real é ela quem diz, depois do envio, e costuma ser bem menos.

integer

avisos

Os códigos de qualidade da base, só em semelhante. Lista vazia significa «nenhum aviso»; campo ausente significa «esta origem não tem avisos».

Array<string>

Example

{
  "publicos": [
    {
      "origem": "montado"
    }
  ]
}

401

Token ausente, malformado ou vencido.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}

403

O token é válido, e o escopo não. Ou ele foi emitido para outro cliente, ou o papel não inclui a permissão da rota. NÃO é 404 de propósito: esconder um erro de escopo atrás de ‘não encontrado’ faz quem integra procurar o problema no lugar errado.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}