Dokumentácia API pre SSP
API platformy na strane ponuky pre programatické reklamné platformy
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 požiadaviek za minútu
Limit počtu požiadaviek sa uplatňuje na každý token SSP
/online-advertisement/{PAID}📊 Kompaktný formát označenia
Tento koncový bod vracia kompaktné označenie transparentnosti v súlade s predpismi EÚ, vhodné na zobrazenie vedľa online reklám. Funguje len pre reklamy s médiom = "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"
}Zobrazte štítok na svojej platforme:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formát hlavičky
Authorization: Bearer YOUR_SSP_TOKENFormát tokenu
64-znakový hexadecimálny reťazec (256-bitová entropia)
Správa tokenov
Tokeny SSP spravujú iba správcovia systému. Ak chcete získať token, obráťte sa na svojho správcu.
Neuplatňuje sa žiadny plán predplatného
Token SSP sa vydáva integrátorovi, nie vydavateľovi, takže nie je viazaný na žiadny účet vydavateľa a neoveruje sa žiadny plán. Na rozdiel od partnerského API tu nič nezávisí od predplatného. Partnerský token tento koncový bod odmietne s kódom 401 a token SSP rovnako odmietnu partnerské koncové body.
Kedy koncový bod vráti 404
Oznámenie sa vyhľadáva podľa rovnakého pravidla viditeľnosti ako vo verejnom registri. Oznámenie, ktoré ešte nie je potvrdené, ktoré jeho vydavateľ ešte neschválil alebo ktorého dátum začiatku zverejnenia ešte nenastal, vráti 404. Kód 404 preto nie je dôkazom, že PA-ID je nesprávne.
Koncový bod vyššie vracia jednoriadkový TEXT štítku pre štítok, ktorý vykresľuje vaša vlastná platforma. Odznak vracia vykreslené interaktívne oznámenie, ktoré umiestnite vedľa reklamy ako prvok iframe. Obidve opisujú to isté oznámenie o transparentnosti.
Jedna adresa URL pre každú verziu
Ovládacie prvky ukážky zodpovedajú týmto parametrom jeden k jednému, takže si môžete vybrať na stránke ukážky a skopírovať adresu URL, ktorú vidíte.
# Rohový odznak, iba značka
GET https://polads.eu/badge/{PA-ID}
# Rohový odznak s textom
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Stále viditeľný pás so štítkom
GET https://polads.eu/badge/{PA-ID}?layout=labelČo robí každý parameter a čo znamená jeho vynechanie
layout=label vyberie pás s označením. Ak ho vynecháte, zobrazí sa rohový odznak. variant=labelled zobrazí text na zatvorenom odznaku. Ak ho vynecháte, zobrazí sa len samotná značka. w a h určujú miesto, v ktorom je odznak umiestnený, a volia, ako sa odznak prispôsobí v tesnom priestore. Ak ich vynecháte, odznak predpokladá, že má dostatok miesta, čo je pre štandardné formáty správne.
hover=0 je určený pre ukážku, nie pre vašu stránku
Vynúti rozloženie pre zariadenia bez ukazovateľa myši, aby ukážka mohla zobraziť dotykovú verziu v prehliadači na počítači. Skutočný odznak si zariadenie overí sám. Ak hodnotu napevno nastavíte, pošlete nesprávnu verziu každému návštevníkovi, ktorého zariadenie je iného typu.
Poslucháč zmeny veľkosti je nevyhnutný
Rohový odznak sa načíta vo veľkosti 32 krát 32, aby zakryl čo najmenšiu časť kreatívy, a keď sa otvára, požiada hostiteľskú stránku o miesto. Bez poslucháča sa nemôže otvoriť vôbec. Pás s označením sa v tesnom priestore prispôsobuje miernejšie a oreže sa len pri malých šírkach.
Dostupné len pre zverejnené oznámenie
Odznak sa poskytuje, keď je oznámenie potvrdené, schválené vydavateľom a uplynul dátum začiatku jeho zverejnenia. PA-ID pod embargom alebo bez schválenia vracia 404 zámerne, nie v dôsledku chyby.
401 Neoprávnené
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Chybná požiadavka
Inzerát sa našiel, ale jeho médium nie je online. Odpoveď vracia skutočnú hodnotu média, napríklad print. Chýbajúce alebo neznáme PA-ID vráti namiesto toho 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Nenájdené
{
"error": "Advertisement not found"
}429 Prekročený limit počtu požiadaviek
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Toto je verzia API v1 a každá odpoveď to uvádza v hlavičke X-API-Version. Zmeny narúšajúce kompatibilitu sa vydávajú pod novou cestou, táto cesta sa nemení. Koncový bod v1 nebude vypnutý bez hlavičky Deprecation odoslanej najmenej 90 dní vopred, v súlade s RFC 8594.
Strojovo čitateľná špecifikácia
Úplný dokument OpenAPI 3.1 je dostupný na adrese /api/docs. Nasmerujte naň priamo Postman, Swagger UI alebo generátor klienta, namiesto toho, aby ste túto stránku prepisovali.
https://polads.eu/api/docs