SSP API-Dokumentation
Supply-Side-Plattform-API für programmatische Werbeplattformen
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10.000 Anfragen pro Minute
Ratenbegrenzung pro SSP-Token erzwungen
/online-advertisement/{PAID}📊 Kompaktes Etikettenformat
Dieser Endpunkt gibt ein kompaktes, EU-konformes Transparenzetikett zurück, das zur Anzeige neben Online-Werbung geeignet ist. Funktioniert nur für Anzeigen mit 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"
}Zeigen Sie das Label auf Ihrer Plattform an:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Header-Format
Authorization: Bearer YOUR_SSP_TOKENToken-Format
Hexadezimale Zeichenfolge mit 64 Zeichen (256-Bit-Entropie)
Token-Verwaltung
SSP-Tokens werden nur von Systemadministratoren verwaltet. Wenden Sie sich an Ihren Administrator, um ein Token zu erhalten.
Kein Tarif ist anwendbar
Ein SSP-Token wird an einen Integrator und nicht an einen Herausgeber ausgegeben, es gehört also zu keinem Herausgeberkonto und es gibt keinen Tarif zu prüfen. Anders als bei der Partner-API hängt hier nichts von einem Abonnement ab. Ein Partner-Token wird an diesem Endpunkt mit 401 abgewiesen, und ein SSP-Token wird an den Partner-Endpunkten genauso abgewiesen.
Wann der Endpunkt 404 zurückgibt
Die Anzeige wird über dieselbe Sichtbarkeitsregel aufgelöst wie das öffentliche Register. Eine Anzeige, die noch nicht bestätigt ist, die der Herausgeber noch nicht freigegeben hat oder deren Veröffentlichungsbeginn noch in der Zukunft liegt, ergibt 404. Ein 404 ist daher kein Beleg dafür, dass eine PA-ID falsch ist.
Der Endpunkt oben liefert den einzeiligen Kennzeichnungstext für eine Kennzeichnung, die Ihre eigene Plattform zeichnet. Das Kennzeichen liefert einen fertigen, interaktiven Hinweis, den Sie als iframe neben die Werbung setzen. Beide beschreiben denselben Transparenzhinweis.
Eine URL pro Version
Die Bedienelemente der Demo entsprechen diesen Parametern eins zu eins, Sie können also auf der Demoseite auswählen und die angezeigte URL kopieren.
# Eckabzeichen, nur die Marke
GET https://polads.eu/badge/{PA-ID}
# Eckabzeichen mit Beschriftung
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Dauerhaft sichtbarer Kennzeichnungsstreifen
GET https://polads.eu/badge/{PA-ID}?layout=labelWas jeder Parameter bewirkt und was das Weglassen bedeutet
layout=label wählt den Streifen, ohne ihn erscheint das Eckabzeichen. variant=labelled zeigt die Beschriftung am geschlossenen Abzeichen, ohne ihn nur die Marke. w und h geben den Platz an, in dem das Abzeichen sitzt, und bestimmen, wie es sich bei wenig Platz anpasst. Ohne sie geht das Abzeichen von ausreichend Platz aus, was für die Standardformate richtig ist.
hover=0 gehört zur Demo, nicht auf Ihre Seite
Es erzwingt die Darstellung ohne Hover, damit die Demo die Touch-Version im Desktop-Browser zeigen kann. Das echte Abzeichen prüft das Gerät selbst. Wer den Wert festschreibt, liefert allen Besuchenden mit abweichendem Gerät die falsche Version.
Der Empfänger für die Größenmeldung ist erforderlich
Das Eckkennzeichen lädt mit 32 mal 32, damit es so wenig wie möglich vom Werbemittel verdeckt, und bittet die Seite beim Öffnen um Platz. Ohne den Empfänger lässt es sich gar nicht öffnen. Der Kennzeichnungsstreifen ist gutmütiger und wird nur bei schmalen Breiten abgeschnitten.
Nur für einen veröffentlichten Hinweis
Das Kennzeichen wird ausgeliefert, sobald der Hinweis bestätigt, vom Anbieter freigegeben und sein Startdatum erreicht ist. Eine gesperrte oder nicht freigegebene PA-ID antwortet absichtlich mit 404, nicht wegen eines Fehlers.
401 Nicht autorisiert
{ "error": "Invalid or revoked SSP API token." }400 Ungültige Anfrage
Die Anzeige wurde gefunden, aber ihr Medium ist nicht online. Die Antwort liefert den tatsächlichen Medienwert, zum Beispiel print. Eine fehlende oder unbekannte PA-ID liefert stattdessen 404.
404 Nicht gefunden
{ "error": "Advertisement not found" }429 Ratenlimit überschritten
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30:00.000Z"
}Dies ist API-Version v1, und jede Antwort sagt das in einem X-API-Version-Header. Brechende Änderungen erscheinen unter einem neuen Pfad, statt diesen zu ändern. Ein v1-Endpunkt wird nicht abgeschaltet, ohne dass mindestens 90 Tage vorher ein Deprecation-Header gesetzt wird, gemäß RFC 8594.
Maschinenlesbare Spezifikation
Das vollständige OpenAPI-3.1-Dokument wird unter /api/docs ausgeliefert. Richten Sie Postman, Swagger UI oder einen Client-Generator direkt darauf, statt diese Seite abzuschreiben.
https://polads.eu/api/docs