Dokumentacja API SSP
API platformy po stronie podaży dla platform reklamy programatycznej
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10 000 żądań na minutę
Limit liczby żądań obowiązuje osobno dla każdego tokena SSP
/online-advertisement/{PAID}📊 Kompaktowy format etykiety
Ten punkt końcowy zwraca kompaktową etykietę przejrzystości zgodną z przepisami UE, odpowiednią do wyświetlania obok reklam internetowych. Działa tylko w przypadku reklam z 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"
}Wyświetl etykietę na swojej platformie:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Format nagłówka
Authorization: Bearer YOUR_SSP_TOKENFormat tokena
64-znakowy ciąg szesnastkowy (entropia 256-bitowa)
Zarządzanie tokenami
Tokenami SSP zarządzają wyłącznie administratorzy systemu. Skontaktuj się z administratorem, aby uzyskać token.
Nie obowiązuje żaden plan subskrypcji
Token SSP jest wydawany integratorowi, a nie wydawcy, więc nie jest powiązany z żadnym kontem wydawcy i nie ma planu do sprawdzenia. W odróżnieniu od API partnerskiego nic tutaj nie zależy od subskrypcji. Token partnera jest odrzucany na tym punkcie końcowym z kodem 401, a token SSP jest w ten sam sposób odrzucany na punktach końcowych partnera.
Kiedy punkt końcowy zwraca 404
Ogłoszenie jest wyszukiwane według tej samej reguły widoczności co w rejestrze publicznym. Dla ogłoszenia, które nie zostało jeszcze potwierdzone, którego wydawca jeszcze nie zatwierdził albo którego data rozpoczęcia publikacji jeszcze nie nadeszła, zwracany jest kod 404. Kod 404 nie dowodzi więc, że PA-ID jest błędny.
Powyższy punkt końcowy zwraca jednowierszowy TEKST etykiety, którą rysuje Twoja własna platforma. Oznaczenie zwraca gotowe, interaktywne ogłoszenie, które umieszczasz obok reklamy w osadzonej ramce. Oba opisują to samo ogłoszenie o przejrzystości.
Jeden adres URL dla każdej wersji
Elementy sterujące pokazu odpowiadają tym parametrom jeden do jednego, więc możesz dokonać wyboru na stronie pokazu i skopiować widoczny adres URL.
# Oznaczenie narożne, sam znak
GET https://polads.eu/badge/{PA-ID}
# Oznaczenie narożne z napisem
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Stale widoczny pasek oznaczenia
GET https://polads.eu/badge/{PA-ID}?layout=labelCo robi każdy parametr i co oznacza jego pominięcie
layout=label wybiera pasek. Bez niego wyświetla się oznaczenie narożne. variant=labelled sprawia, że zamknięte oznaczenie pokazuje swój napis. Bez niego wyświetla się sam znak. w i h określają miejsce, w którym znajduje się oznaczenie, i decydują, jak dostosowuje się ono przy braku miejsca. Po ich pominięciu oznaczenie zakłada, że ma wystarczająco miejsca, co jest właściwe dla standardowych formatów.
hover=0 służy do pokazu, nie do Twojej strony
Wymusza układ bez najechania kursorem, aby pokaz mógł przedstawić wersję dotykową w przeglądarce na komputerze. Prawdziwe oznaczenie samo sprawdza urządzenie. Jeśli ustawisz ten parametr na stałe, wyślesz niewłaściwą wersję każdemu odwiedzającemu, którego urządzenie działa inaczej.
Obsługa komunikatu o zmianie rozmiaru jest wymagana
Oznaczenie narożne ładuje się w rozmiarze 32 na 32, aby zasłaniać jak najmniej kreacji, a przy otwarciu prosi stronę nadrzędną o więcej miejsca. Bez obsługi tego komunikatu w ogóle nie może się otworzyć. Pasek oznaczenia dostosowuje się łagodniej i jest przycinany tylko przy małych szerokościach.
Dostępne tylko dla opublikowanego ogłoszenia
Oznaczenie jest udostępniane, gdy ogłoszenie zostało potwierdzone, zatwierdzone przez wydawcę i minęła data rozpoczęcia jego publikacji. Dla PA-ID objętego embargiem lub niezatwierdzonego zwracany jest kod 404 celowo, a nie z powodu błędu.
401 Nieautoryzowane
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Nieprawidłowe żądanie
Reklama została znaleziona, ale jej medium nie jest online. Odpowiedź zwraca rzeczywistą wartość medium, na przykład print. Brakujący lub nieznany PA-ID zwraca zamiast tego 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Nie znaleziono
{
"error": "Advertisement not found"
}429 Przekroczono limit żądań
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}To jest wersja v1 API, co każda odpowiedź potwierdza w nagłówku X-API-Version. Zmiany naruszające zgodność są wprowadzane pod nową ścieżką, a ta pozostaje bez zmian. Punkt końcowy v1 nie zostanie wyłączony bez nagłówka Deprecation wysłanego co najmniej 90 dni wcześniej, zgodnie z RFC 8594.
Specyfikacja odczytywalna maszynowo
Pełny dokument OpenAPI 3.1 jest dostępny pod adresem /api/docs. Wskaż go bezpośrednio w Postmanie, Swagger UI lub generatorze klienta, zamiast przepisywać tę stronę.
https://polads.eu/api/docs