Documentação da API SSP
API de plataforma do lado da oferta para plataformas de publicidade programática
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 pedidos por minuto
Limite de pedidos aplicado por token SSP
/online-advertisement/{PAID}📊 Formato de rótulo compacto
Este endpoint devolve um rótulo de transparência compacto, conforme com a legislação da UE, adequado para apresentação junto de anúncios em linha. Só funciona para anúncios com medium = "online".
curl -X GET "https://polads.eu/api/v1/online-advertisement/ABC12" \
-H "Authorization: Bearer YOUR_SSP_TOKEN" \
-H "Accept: application/json"{
"text": "Politisk Reklame - ACME Corp - Folketingsvalg - polads.eu/ABC12",
"link": "https://polads.eu/ABC12",
"PAID": "ABC12"
}Apresente o rótulo na sua plataforma:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formato do cabeçalho
Authorization: Bearer YOUR_SSP_TOKENFormato do token
Sequência hexadecimal de 64 caracteres (entropia de 256 bits)
Gestão de tokens
Os tokens SSP são geridos apenas pelos administradores de sistema. Contacte o seu administrador para obter um token.
Não se aplica nenhum plano de subscrição
Um token SSP é emitido a um integrador e não a um editor, pelo que não está associado a nenhuma conta de editor e não há plano a verificar. Ao contrário da API de parceiros, nada aqui depende de uma subscrição. Um token de parceiro é rejeitado neste ponto final com 401, e um token SSP é rejeitado da mesma forma nos pontos finais de parceiros.
Quando o ponto final devolve 404
O aviso é determinado segundo a mesma regra de visibilidade do registo público. Um aviso que ainda não esteja confirmado, que o seu editor ainda não tenha aprovado ou cuja data de início de publicação ainda esteja no futuro devolve 404. Assim, um 404 não prova que um PA-ID esteja errado.
O ponto final acima devolve o TEXTO do rótulo numa só linha, para um rótulo desenhado pela sua própria plataforma. O distintivo devolve um aviso interativo já composto, que coloca junto ao anúncio como iframe. Ambos descrevem o mesmo aviso de transparência.
Um URL por versão
Os controlos da demonstração correspondem um a um a estes parâmetros, pelo que pode escolher na página de demonstração e copiar o URL que vê.
# Distintivo de canto, apenas a marca
GET https://polads.eu/badge/{PA-ID}
# Distintivo de canto com o respetivo texto
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Faixa de rótulo sempre visível
GET https://polads.eu/badge/{PA-ID}?layout=labelO que faz cada parâmetro e o que significa omiti-lo
layout=label seleciona a faixa. Se o omitir, obtém o distintivo de canto. variant=labelled faz com que o distintivo fechado mostre o seu texto. Se o omitir, obtém apenas a marca. w e h declaram o espaço onde o distintivo se insere e determinam como se adapta quando há pouco espaço. Se os omitir, o distintivo assume que tem espaço suficiente, o que é adequado para os formatos padrão.
hover=0 é para a demonstração, não para a sua página
Força a apresentação para dispositivos sem ponteiro, para que a demonstração possa mostrar a versão tátil num navegador de computador. O distintivo real verifica o dispositivo por si próprio. Se fixar este valor no código, envia a versão errada a todos os visitantes cujo dispositivo não corresponda.
O recetor de redimensionamento é obrigatório
O distintivo de canto carrega com 32 por 32 para cobrir o mínimo possível do criativo e, ao abrir, pede espaço à página de alojamento. Sem o recetor, não consegue sequer abrir. A faixa de identificação adapta-se de forma mais suave e só é cortada em larguras reduzidas.
Disponível apenas para um aviso publicado
O distintivo é disponibilizado quando o aviso está confirmado, aprovado pelo editor e já passou a sua data de início de publicação. Um PA-ID sob embargo ou não aprovado responde 404 intencionalmente, não por erro.
Abrir a demonstração interativa e copiar o código de incorporação
401 Não autorizado
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Pedido inválido
O anúncio foi encontrado, mas o seu meio não é online. A resposta devolve o valor real do meio, por exemplo print. Um PA-ID em falta ou desconhecido devolve 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Não encontrado
{
"error": "Advertisement not found"
}429 Limite de pedidos excedido
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Esta é a versão v1 da API, e todas as respostas o indicam num cabeçalho X-API-Version. As alterações incompatíveis são publicadas num novo caminho, em vez de alterarem este. Um ponto final v1 não será desativado sem um cabeçalho Deprecation enviado com, pelo menos, 90 dias de antecedência, em conformidade com o RFC 8594.
Especificação legível por máquina
O documento OpenAPI 3.1 completo é disponibilizado em /api/docs. Aponte o Postman, o Swagger UI ou um gerador de clientes diretamente para ele, em vez de transcrever esta página.
https://polads.eu/api/docs