Documentación API SSP
API de plataforma del lado de la oferta para plataformas publicitarias programáticas
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10.000 solicitudes por minuto
Límite de tasa aplicado por token SSP
/online-advertisement/{PAID}📊 Formato de etiqueta compacta
Este terminal devuelve una etiqueta transparente compacta que cumple con la UE y adecuada para mostrarse junto con anuncios en línea. Sólo funciona para anuncios con medio = "en línea".
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"
}Muestra la etiqueta en tu plataforma:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formato de encabezado
Authorization: Bearer YOUR_SSP_TOKENFormato de token
cadena hexadecimal de 64 caracteres (entropía de 256 bits)
Gestión de tokens
Los tokens SSP son administrados únicamente por administradores del sistema. Póngase en contacto con su administrador para obtener un token.
No se aplica ningún plan
Un token SSP se emite a un integrador y no a un editor, por lo que no pertenece a ninguna cuenta de editor y no hay 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 endpoint con 401, y un token SSP se rechaza igual en los endpoints de socio.
Cuándo el endpoint devuelve 404
El anuncio se resuelve con la misma regla de visibilidad que el registro público. Un anuncio que aún no está confirmado, que el editor aún no ha aprobado, o cuya fecha de inicio de publicación está todavía en el futuro devuelve 404. Un 404 no prueba, por tanto, que un PA-ID sea incorrecto.
El punto final anterior devuelve el texto de la etiqueta en una línea, para una etiqueta que dibuja su propia plataforma. El distintivo devuelve un aviso interactivo ya compuesto, que usted coloca junto al anuncio en un marco. 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 identificación siempre visible
GET https://polads.eu/badge/{PA-ID}?layout=labelQué hace cada parámetro y qué significa omitirlo
layout=label selecciona la franja, sin él aparece el distintivo de esquina. variant=labelled muestra el texto en el distintivo cerrado, sin él queda solo la marca. w y h declaran el espacio en el que se sitúa el distintivo y deciden cómo se adapta cuando hay poco sitio. Si los omite, el distintivo da por hecho que tiene espacio, lo que 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 lo fija, envía la versión equivocada a todo visitante cuyo dispositivo diga lo contrario.
El receptor del cambio de tamaño es obligatorio
El distintivo de esquina se carga en 32 por 32 para tapar lo menos posible del creativo, y luego pide sitio a la página cuando se abre. Sin el receptor no puede abrirse en absoluto. La franja es más tolerante y solo se recorta en anchuras estrechas.
Disponible solo para un aviso publicado
El distintivo se sirve cuando el aviso está confirmado, aprobado por el editor y pasada su fecha de inicio. Un PA-ID bajo embargo o sin aprobar responde 404 a propósito, 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." }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.
404 No encontrado
{ "error": "Advertisement not found" }429 Límite de tarifa excedido
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30:00.000Z"
}Esta es la versión de API v1, y cada respuesta lo indica en una cabecera X-API-Version. Los cambios incompatibles se publican bajo una ruta nueva en lugar de modificar esta. Un endpoint v1 no se desactivará sin una cabecera Deprecation 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. Apunte Postman, Swagger UI o un generador de clientes directamente ahí en lugar de transcribir esta página.
https://polads.eu/api/docs