Documentación de la API SSP
API de plataforma del lado de la oferta para plataformas de publicidad programática
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10.000 solicitudes por minuto
Límite de solicitudes aplicado por token SSP
/online-advertisement/{PAID}📊 Formato de etiqueta compacta
Este punto final devuelve una etiqueta de transparencia compacta, conforme con la normativa de la UE, adecuada para mostrarse junto a anuncios en línea. Solo funciona con anuncios cuyo medio sea 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"
}Muestre la etiqueta en su plataforma:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formato de la cabecera
Authorization: Bearer YOUR_SSP_TOKENFormato del token
Cadena hexadecimal de 64 caracteres (entropía de 256 bits)
Gestión de tokens
Los tokens SSP solo los gestionan los administradores del sistema. Póngase en contacto con su administrador para obtener un token.
No se aplica ningún plan de suscripción
Un token SSP se emite a un integrador y no a un editor, por lo que no está vinculado a ninguna cuenta de editor y no hay ningún plan que comprobar. A diferencia de la API de socios, aquí nada depende de una suscripción. Un token de socio se rechaza en este punto final con 401, y un token SSP se rechaza del mismo modo en los puntos finales de socios.
Cuándo devuelve 404 el punto final
El aviso se resuelve con la misma regla de visibilidad que el registro público. Un aviso que aún no está confirmado, que su editor aún no ha aprobado o cuya fecha de inicio de publicación todavía no ha llegado devuelve 404. Por tanto, un 404 no prueba que un PA-ID sea incorrecto.
El punto final anterior devuelve el TEXTO de la etiqueta en una sola línea, para una etiqueta que dibuja su propia plataforma. El distintivo devuelve un aviso interactivo ya representado, que usted coloca junto al anuncio como iframe. Ambos describen el mismo aviso de transparencia.
Una URL por versión
Los controles de la demostración se corresponden uno a uno con estos parámetros, así que puede elegir en la página de demostración y copiar la URL que ve.
# Distintivo de esquina, solo la marca
GET https://polads.eu/badge/{PA-ID}
# Distintivo de esquina con su texto
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Franja de etiqueta siempre visible
GET https://polads.eu/badge/{PA-ID}?layout=labelQué hace cada parámetro y qué significa omitirlo
layout=label selecciona la franja. Si lo omite, se muestra el distintivo de esquina. variant=labelled hace que el distintivo cerrado muestre su texto. Si lo omite, solo aparece la marca. w y h declaran el espacio en el que se sitúa el distintivo y determinan cómo se adapta cuando hay poco sitio. Si los omite, el distintivo supone que dispone de espacio, lo cual es correcto para los formatos estándar.
hover=0 es para la demostración, no para su página
Fuerza la presentación sin puntero para que la demostración muestre la versión táctil en un navegador de escritorio. El distintivo real comprueba el dispositivo por sí mismo. Si fija este valor en el código, enviará la versión equivocada a todos los visitantes cuyo dispositivo no coincida.
El agente de escucha del cambio de tamaño es obligatorio
El distintivo de esquina se carga a 32 por 32 para tapar lo menos posible de la creatividad y, al abrirse, pide espacio a la página anfitriona. Sin el agente de escucha no puede abrirse en absoluto. La franja de etiqueta se adapta con más suavidad y solo se recorta en anchuras estrechas.
Disponible solo para un aviso publicado
El distintivo se sirve una vez que el aviso está confirmado, aprobado por el editor y ha pasado su fecha de inicio de publicación. Un PA-ID bajo embargo o sin aprobar responde 404 por diseño, no por un fallo.
Abrir la demostración interactiva y copiar el código de inserción
401 No autorizado
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Solicitud incorrecta
Se encontró el anuncio, pero su medio no es online. La respuesta devuelve el valor real del medio, por ejemplo print. Un PA-ID ausente o desconocido devuelve 404 en su lugar.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 No encontrado
{
"error": "Advertisement not found"
}429 Límite de solicitudes excedido
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Esta es la versión v1 de la API, y cada respuesta lo indica en una cabecera X-API-Version. Los cambios incompatibles se publican en una ruta nueva en lugar de modificar esta. Un punto final v1 no se desactivará sin una cabecera Deprecation enviada con al menos 90 días de antelación, conforme a la RFC 8594.
Especificación legible por máquina
El documento OpenAPI 3.1 completo se sirve en /api/docs. Dirija Postman, Swagger UI o un generador de clientes directamente a él en lugar de transcribir esta página.
https://polads.eu/api/docs