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 solicitações por minuto
Limite de taxa aplicado por token SSP
/online-advertisement/{PAID}📊 Formato de etiqueta compacta
Este endpoint retorna um rótulo de transparência compacto e compatível com a UE, adequado para exibição junto com anúncios online. Funciona apenas 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"
}Exiba o rótulo em 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)
Gerenciamento de tokens
Tokens SSP são gerenciados apenas por administradores de sistema. Entre em contato com seu administrador para obter um token.
Não se aplica qualquer plano
Um token SSP é emitido a um integrador e não a um editor, pelo que não pertence a nenhuma conta de editor e não há plano a verificar. Ao contrário da API de parceiros, aqui nada depende de uma subscrição. Um token de parceiro é rejeitado neste endpoint com 401, e um token SSP é rejeitado da mesma forma nos endpoints de parceiro.
Quando o endpoint devolve 404
O anúncio é resolvido com a mesma regra de visibilidade do registo público. Um anúncio que ainda não esteja confirmado, que o editor ainda não tenha aprovado, ou cuja data de início de publicação ainda esteja no futuro devolve 404. Um 404 não prova, portanto, que um PA-ID esteja errado.
O ponto final acima devolve o texto do rótulo numa linha, para um rótulo que a sua própria plataforma desenha. A marca devolve um aviso interativo já composto, que coloca junto ao anúncio numa moldura. 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 texto
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Faixa de identificação 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, sem ele aparece o distintivo de canto. variant=labelled mostra o texto no distintivo fechado, sem ele fica apenas a marca. w e h declaram o espaço em que o distintivo assenta e decidem como se adapta quando há pouco espaço. Se os omitir, o distintivo assume que tem espaço, o que é correto para os formatos padrão.
hover=0 é para a demonstração, não para a sua página
Força a apresentação sem ponteiro para que a demonstração possa mostrar a versão táctil num navegador de computador. O distintivo real verifica o dispositivo por si. Ao fixá-lo, envia a versão errada a cada visitante cujo dispositivo diga o contrário.
O recetor da mudança de tamanho é obrigatório
A marca de canto carrega a 32 por 32 para cobrir o menos possível do criativo, e depois pede espaço à página quando abre. Sem o recetor não abre de todo. A faixa é mais tolerante e só é cortada em larguras estreitas.
Disponível apenas para um aviso publicado
A marca é servida quando o aviso está confirmado, aprovado pelo editor e passada a sua data de início. Um PA-ID sob embargo ou não aprovado responde 404 de propósito, não por falha.
Abrir a demonstração interativa e copiar o código de incorporação
401 Não autorizado
{ "error": "Invalid or revoked SSP API 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.
404 não encontrado
{ "error": "Advertisement not found" }429 Limite de taxa excedido
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30:00.000Z"
}Esta é a versão da API v1, e cada resposta indica-o num cabeçalho X-API-Version. As alterações incompatíveis saem num caminho novo em vez de alterar este. Um endpoint v1 não será desligado sem um cabeçalho Deprecation com pelo menos 90 dias de antecedência, em conformidade com a RFC 8594.
Especificação legível por máquina
O documento OpenAPI 3.1 completo é servido em /api/docs. Aponte o Postman, o Swagger UI ou um gerador de clientes diretamente para lá em vez de transcrever esta página.
https://polads.eu/api/docs