SSP-API-documentatie
SSP-API (supply-side platform) voor programmatische advertentieplatforms
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10.000 verzoeken per minuut
De snelheidslimiet geldt per SSP-token
/online-advertisement/{PAID}📊 Compact labelformaat
Dit eindpunt geeft een compact transparantielabel terug dat aan de EU-regels voldoet en geschikt is om naast online advertenties te tonen. Werkt alleen voor advertenties met 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"
}Toon het label op uw platform:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Headerformaat
Authorization: Bearer YOUR_SSP_TOKENTokenformaat
Hexadecimale tekenreeks van 64 tekens (256 bits entropie)
Tokenbeheer
SSP-tokens worden uitsluitend door systeembeheerders beheerd. Neem contact op met uw beheerder om een token te verkrijgen.
Er geldt geen abonnement
Een SSP-token wordt uitgegeven aan een integrator en niet aan een uitgever. Er is dus geen uitgeversaccount aan gekoppeld en er valt geen abonnement te controleren. Anders dan bij de partner-API hangt hier niets af van een abonnement. Een partnertoken wordt op dit eindpunt geweigerd met 401, en een SSP-token wordt op dezelfde manier geweigerd op de partnereindpunten.
Wanneer het eindpunt 404 teruggeeft
De transparantieverklaring wordt opgezocht volgens dezelfde zichtbaarheidsregel als het openbare register. Een transparantieverklaring die nog niet is bevestigd, die de uitgever nog niet heeft goedgekeurd of waarvan de startdatum van publicatie nog in de toekomst ligt, geeft 404 terug. Een 404 bewijst dus niet dat een PA-ID onjuist is.
Het eindpunt hierboven geeft de TEKST van het label van één regel terug, voor een label dat uw eigen platform weergeeft. De markering geeft een kant-en-klare, interactieve transparantieverklaring terug die u als iframe naast de advertentie plaatst. Beide beschrijven dezelfde transparantieverklaring.
Eén URL per versie
De bedieningselementen van de demo komen één op één overeen met deze parameters. U kunt dus op de demopagina kiezen en de URL kopiëren die u ziet.
# Hoekmarkering, alleen het merkteken
GET https://polads.eu/badge/{PA-ID}
# Hoekmarkering met tekst
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Altijd zichtbare labelbalk
GET https://polads.eu/badge/{PA-ID}?layout=labelWat elke parameter doet en wat het betekent als u hem weglaat
layout=label kiest de aanduidingsbalk. Laat u hem weg, dan krijgt u de hoekmarkering. variant=labelled laat de gesloten markering haar tekst tonen. Laat u hem weg, dan ziet u alleen het merkteken. w en h geven de ruimte op waarin de markering staat en bepalen hoe zij zich aanpast bij weinig ruimte. Laat u ze weg, dan gaat de markering ervan uit dat er ruimte genoeg is, wat klopt voor de standaardformaten.
hover=0 is bedoeld voor de demo, niet voor uw pagina
Het dwingt de weergave zonder aanwijzer af, zodat de demo de aanraakversie in een desktopbrowser kan tonen. De echte markering controleert het apparaat zelf. Legt u de waarde vast, dan krijgt elke bezoeker van wie het apparaat anders werkt de verkeerde versie.
De luisteraar voor formaatwijzigingen is verplicht
De hoekmarkering laadt op 32 bij 32, zodat zij zo weinig mogelijk van de advertentie bedekt, en vraagt de omringende pagina om ruimte wanneer zij opengaat. Zonder de luisteraar kan zij helemaal niet opengaan. De aanduidingsbalk past zich soepeler aan en wordt alleen bij smalle breedtes afgekapt.
Alleen beschikbaar voor een gepubliceerde transparantieverklaring
De markering wordt geleverd zodra de transparantieverklaring is bevestigd, door de uitgever is goedgekeurd en de begindatum van publicatie voorbij is. Een PA-ID onder embargo of zonder goedkeuring geeft bewust 404 terug, niet door een fout.
401 Ongeautoriseerd
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Ongeldig verzoek
De advertentie is gevonden, maar het medium is niet online. De reactie geeft de werkelijke mediumwaarde terug, bijvoorbeeld print. Een ontbrekend of onbekend PA-ID geeft in plaats daarvan 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Niet gevonden
{
"error": "Advertisement not found"
}429 Aanvraaglimiet overschreden
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Dit is API-versie v1, en elke respons vermeldt dat in een kopveld X-API-Version. Incompatibele wijzigingen verschijnen onder een nieuw pad in plaats van dat dit pad wordt gewijzigd. Een v1-eindpunt wordt niet uitgeschakeld zonder minstens 90 dagen vooraf een Deprecation-kopveld, conform RFC 8594.
Machineleesbare specificatie
Het volledige OpenAPI 3.1-document staat op /api/docs. Richt Postman, Swagger UI of een clientgenerator daar rechtstreeks op in plaats van deze pagina over te typen.
https://polads.eu/api/docs