API-dokumentation för SSP
API för säljsidesplattformar (SSP), avsett för plattformar för programmatisk annonsering
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10 000 anrop per minut
Anropsbegränsningen tillämpas per SSP-token
/online-advertisement/{PAID}📊 Kompakt märkningsformat
Den här slutpunkten returnerar en kompakt öppenhetsmärkning som uppfyller EU:s krav och lämpar sig för visning bredvid onlineannonser. Fungerar endast för annonser med 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"
}Visa etiketten på din plattform:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Format för HTTP-huvud
Authorization: Bearer YOUR_SSP_TOKENTokenformat
Hexadecimal sträng med 64 tecken (256 bitars entropi)
Tokenhantering
SSP-token hanteras endast av systemadministratörer. Kontakta din administratör för att få ett token.
Inget abonnemang är tillämpligt
Ett SSP-token utfärdas till en integratör och inte till en utgivare, så det hör inte till något utgivarkonto och det finns inget abonnemang att kontrollera. Till skillnad från partner-API:et beror ingenting här på ett abonnemang. Ett partnertoken avvisas på den här slutpunkten med 401, och ett SSP-token avvisas på partnerslutpunkterna på samma sätt.
När slutpunkten svarar 404
Meddelandet slås upp enligt samma synlighetsregel som det offentliga registret. Ett meddelande som ännu inte är bekräftat, som utgivaren ännu inte har godkänt eller vars startdatum för publicering fortfarande ligger i framtiden ger 404. Ett 404-svar är därför inget bevis för att ett PA-ID är fel.
Slutpunkten ovan returnerar själva märkningstexten på en rad, för en märkning som din egen plattform ritar. Märket returnerar ett färdigt, interaktivt meddelande som du placerar bredvid annonsen i en iframe. Båda beskriver samma transparensmeddelande.
En URL per version
Demonstrationens reglage motsvarar dessa parametrar ett till ett, så du kan välja på demonstrationssidan och kopiera adressen du ser.
# Hörnmärke, endast symbol
GET https://polads.eu/badge/{PA-ID}
# Hörnmärke med text
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Alltid synlig märkningsrad
GET https://polads.eu/badge/{PA-ID}?layout=labelVad varje parameter gör och vad det betyder att utelämna den
layout=label väljer raden. Utelämnar du den visas hörnmärket. variant=labelled gör att det stängda märket visar sin text. Utelämnar du den visas bara märket. w och h anger utrymmet där märket sitter och avgör hur det anpassar sig när det är trångt. Utelämnar du dem utgår märket från att det finns plats, vilket stämmer för standardformaten.
hover=0 hör till demonstrationen, inte till din sida
Den tvingar fram layouten utan hovring så att demonstrationen kan visa pekskärmsversionen i en datorwebbläsare. Det riktiga märket testar enheten själv. Låser du värdet skickar du fel version till varje besökare vars enhet inte stämmer med det.
Lyssnaren för storleksändring krävs
Hörnmärket laddas i 32 gånger 32 så att det täcker så lite av annonsmaterialet som möjligt, och ber sedan värdsidan om utrymme när det öppnas. Utan lyssnaren går det inte att öppna alls. Märkningsraden anpassar sig mjukare och beskärs bara vid smala bredder.
Endast tillgängligt för ett publicerat meddelande
Märket levereras när meddelandet är bekräftat, godkänt av utgivaren och publiceringens startdatum har passerats. Ett PA-ID under embargo eller utan godkännande svarar 404 avsiktligt, inte på grund av ett fel.
Öppna den interaktiva demonstrationen och kopiera inbäddningskoden
401 Obehörig
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Felaktig begäran
Annonsen hittades, men dess medium är inte online. Svaret returnerar det faktiska mediumvärdet, till exempel print. Ett PA-ID som saknas eller är okänt ger i stället 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Hittades inte
{
"error": "Advertisement not found"
}429 Anropsgränsen har överskridits
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Detta är API-version v1, och varje svar anger det i huvudet X-API-Version. Ändringar som inte är bakåtkompatibla publiceras under en ny sökväg i stället för att den här ändras. En v1-slutpunkt stängs inte av utan ett Deprecation-huvud minst 90 dagar i förväg, enligt RFC 8594.
Maskinläsbar specifikation
Hela OpenAPI 3.1-dokumentet finns på /api/docs. Rikta Postman, Swagger UI eller en klientgenerator direkt dit i stället för att skriva av den här sidan.
https://polads.eu/api/docs