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 transparente compacte et conforme aux normes de l'UE, pouvant ê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 le label sur votre plateforme :
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Format d'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 ne s’applique
Un jeton SSP est délivré à un intégrateur et non à un éditeur, il ne relève donc d’aucun compte éditeur et il n’y a pas de formule à 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 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’annonce est résolue selon la même règle de visibilité que le registre public. Une annonce qui n’est pas encore confirmée, que l’éditeur n’a pas encore validée, 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 du bandeau sur une ligne, pour un bandeau que votre propre plateforme dessine. La marque renvoie un avis interactif prêt à l’emploi, que vous placez à côté de la publicité dans un cadre. 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 lui vous obtenez la pastille d'angle. variant=labelled affiche la mention sur la pastille fermée, sans lui la marque seule. w et h déclarent l'emplacement qui accueille la pastille et déterminent son adaptation quand la place manque. Sans eux, la pastille suppose qu'elle a de la place, ce qui convient aux formats standards.
hover=0 sert à la démonstration, pas à votre page
Il force l'affichage sans survol pour que la démonstration montre la version tactile dans un navigateur de bureau. La vraie pastille teste l'appareil elle-même. La figer revient à envoyer la mauvaise version à tout visiteur dont l'appareil dit le contraire.
L’écouteur de redimensionnement est obligatoire
La marque 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 est plus tolérant et n’est coupé que sur les colonnes étroites.
Disponible uniquement pour un avis publié
La marque est servie une fois l’avis confirmé, validé par l’éditeur et sa date de début passée. Un PA-ID sous embargo ou non validé répond 404 à dessein, et non à cause d’une erreur.
Ouvrir la démonstration interactive et copier le code d’intégration
401 Non autorisé
{ "error": "Invalid or revoked SSP API 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.
404 Introuvable
{ "error": "Advertisement not found" }429 Limite de débit dépassée
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30: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 paraissent 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 au moins 90 jours à l’avance, conformément à la RFC 8594.
Spécification lisible par une 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