Documentation de l'API SSP
API de plateforme côté offre pour les plateformes publicitaires programmatiques
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10 000 requêtes par minute
Limite de débit appliquée par jeton SSP
/online-advertisement/{PAID}📊 Format d'étiquette compact
Ce point de terminaison renvoie une étiquette de transparence compacte et conforme au droit de l'UE, destinée à être affichée à côté des publicités en ligne. Fonctionne uniquement pour les publicités avec 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"
}Affichez l'étiquette sur votre plateforme :
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Format de l'en-tête
Authorization: Bearer YOUR_SSP_TOKENFormat du jeton
Chaîne hexadécimale de 64 caractères (entropie de 256 bits)
Gestion des jetons
Les jetons SSP sont gérés uniquement par les administrateurs système. Contactez votre administrateur pour obtenir un jeton.
Aucune formule d’abonnement ne s’applique
Un jeton SSP est délivré à un intégrateur et non à un éditeur : il n’est rattaché à aucun compte éditeur et aucune formule n’est à vérifier. Contrairement à l’API partenaire, rien ici ne dépend d’un abonnement. Un jeton partenaire est rejeté sur ce point de terminaison avec le code 401, et un jeton SSP est rejeté de la même façon sur les points de terminaison partenaires.
Quand le point de terminaison renvoie 404
L’avis est résolu selon la même règle de visibilité que le registre public. Un avis qui n’est pas encore confirmé, que son éditeur n’a pas encore validé ou dont la date de début de publication est encore à venir renvoie 404. Un 404 ne prouve donc pas qu’un PA-ID est erroné.
Le point de terminaison ci-dessus renvoie le TEXTE de l’étiquette sur une ligne, pour une étiquette que votre propre plateforme affiche. La pastille renvoie un avis interactif prêt à l’affichage, que vous placez à côté de la publicité dans un cadre intégré. Les deux décrivent le même avis de transparence.
Une URL par version
Les commandes de la démonstration correspondent une à une à ces paramètres : vous pouvez choisir sur la page de démonstration et copier l'URL affichée.
# Pastille d'angle, marque seule
GET https://polads.eu/badge/{PA-ID}
# Pastille d'angle avec sa mention
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Bandeau de mention toujours visible
GET https://polads.eu/badge/{PA-ID}?layout=labelCe que fait chaque paramètre, et ce que signifie son absence
layout=label sélectionne le bandeau. Sans ce paramètre, vous obtenez la pastille d'angle. variant=labelled affiche la mention sur la pastille fermée. Sans ce paramètre, seule la marque s'affiche. w et h déclarent l'emplacement qui accueille la pastille et déterminent son adaptation quand la place manque. Sans eux, la pastille considère qu'elle dispose de la place nécessaire, ce qui convient aux formats standard.
hover=0 est réservé à la démonstration, pas à votre page
Ce paramètre force l'affichage sans survol afin que la démonstration puisse montrer la version tactile dans un navigateur de bureau. La vraie pastille détecte elle-même le type d'appareil. Si vous figez cette valeur, vous envoyez la mauvaise version à chaque visiteur dont l'appareil ne correspond pas.
L’écouteur de redimensionnement est obligatoire
La pastille d'angle se charge en 32 sur 32 pour couvrir le moins possible de la création, puis demande de la place à la page hôte lorsqu’elle s’ouvre. Sans l’écouteur, elle ne peut pas s’ouvrir du tout. Le bandeau de mention se dégrade plus progressivement et n’est tronqué qu’aux faibles largeurs.
Disponible uniquement pour un avis publié
La pastille est servie une fois l’avis confirmé, validé par l’éditeur et sa date de début de publication passée. Un PA-ID sous embargo ou non validé renvoie 404 par conception, et non par erreur.
Ouvrir la démonstration interactive et copier le code d’intégration
401 Non autorisé
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Requête incorrecte
L’annonce a été trouvée, mais son support n’est pas online. La réponse renvoie la valeur réelle du support, par exemple print. Un PA-ID absent ou inconnu renvoie 404 à la place.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Introuvable
{
"error": "Advertisement not found"
}429 Limite de débit dépassée
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Il s’agit de la version d’API v1, et chaque réponse l’indique dans un en-tête X-API-Version. Les changements incompatibles sont publiés sous un nouveau chemin plutôt que de modifier celui-ci. Un point de terminaison v1 ne sera pas désactivé sans un en-tête Deprecation envoyé au moins 90 jours à l’avance, conformément à la RFC 8594.
Spécification lisible par machine
Le document OpenAPI 3.1 complet est servi sur /api/docs. Pointez Postman, Swagger UI ou un générateur de client directement dessus plutôt que de recopier cette page.
https://polads.eu/api/docs