Dokumentace SSP API
API platformy na straně nabídky pro platformy programatické reklamy
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10 000 požadavků za minutu
Limit počtu požadavků se uplatňuje pro každý token SSP zvlášť
/online-advertisement/{PAID}📊 Kompaktní formát označení
Tento koncový bod vrací kompaktní označení transparentnosti v souladu s předpisy EU, vhodné k zobrazení vedle online reklam. Funguje pouze pro reklamy s médiem = "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ítek na své platformě:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formát hlavičky
Authorization: Bearer YOUR_SSP_TOKENFormát tokenu
64znakový hexadecimální řetězec (256bitová entropie)
Správa tokenů
Tokeny SSP spravují pouze správci systému. Chcete-li získat token, obraťte se na svého správce.
Neuplatňuje se žádný tarif předplatného
Token SSP se vydává integrátorovi, nikoli vydavateli, proto k němu nepatří žádný účet vydavatele a není žádný tarif k ověření. Na rozdíl od partnerského API zde nic nezávisí na předplatném. Partnerský token je na tomto koncovém bodu odmítnut s kódem 401 a token SSP je stejným způsobem odmítnut na partnerských koncových bodech.
Kdy koncový bod vrací 404
Oznámení se vyhledává podle stejného pravidla viditelnosti jako ve veřejném rejstříku. Oznámení, které dosud není potvrzeno, které jeho vydavatel dosud neschválil nebo jehož datum zahájení zveřejnění je teprve v budoucnosti, vrací 404. Kód 404 proto není důkazem, že je PA-ID chybné.
Koncový bod výše vrací jednořádkový TEXT štítku pro štítek, který vykresluje vaše vlastní platforma. Odznak vrací vykreslené interaktivní oznámení, které umístíte vedle reklamy do vloženého rámu (iframe). Obojí popisuje totéž oznámení o transparentnosti.
Jedna adresa URL pro každou verzi
Ovládací prvky ukázky odpovídají těmto parametrům jedna ku jedné, takže můžete volbu provést na stránce ukázky a zkopírovat adresu URL, kterou uvidíte.
# Rohový odznak, pouze značka
GET https://polads.eu/badge/{PA-ID}
# Rohový odznak s popisem
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Trvale viditelný pruh s označením
GET https://polads.eu/badge/{PA-ID}?layout=labelCo jednotlivé parametry dělají a co znamená jejich vynechání
layout=label vybere pruh. Bez něj se zobrazí rohový odznak. variant=labelled zobrazí na zavřeném odznaku jeho popis. Bez něj zůstane jen značka. w a h udávají místo, do kterého je odznak vložen, a určují, jak se zjednoduší v omezeném prostoru. Pokud je vynecháte, odznak předpokládá, že má dost místa, což je pro standardní formáty správné.
hover=0 patří k ukázce, ne na vaši stránku
Vynutí rozvržení bez najetí myší, aby ukázka mohla zobrazit dotykovou verzi v prohlížeči na počítači. Skutečný odznak si zařízení ověří sám. Pokud hodnotu napevno nastavíte, zobrazíte nesprávnou verzi každému návštěvníkovi, jehož zařízení se s ní neshoduje.
Posluchač změny velikosti je povinný
Rohový odznak se načte ve velikosti 32 krát 32, aby co nejméně zakrýval reklamní motiv, a při otevření požádá hostitelskou stránku o místo. Bez posluchače se vůbec nemůže otevřít. Pruh s označením se v omezeném prostoru zjednodušuje šetrněji a ořízne se jen při malé šířce.
Dostupné pouze pro zveřejněné oznámení
Odznak se poskytuje, jakmile je oznámení potvrzeno, schváleno vydavatelem a nastalo datum zahájení jeho zveřejnění. PA-ID pod embargem nebo bez schválení vrací 404 záměrně, nikoli v důsledku chyby.
401 Neoprávněné
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Chybný požadavek
Inzerát byl nalezen, ale jeho médium není online. Odpověď vrací skutečnou hodnotu média, například print. Chybějící nebo neznámé PA-ID vrací místo toho 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Nenalezeno
{
"error": "Advertisement not found"
}429 Překročen limit počtu požadavků
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Toto je verze API v1 a každá odpověď to uvádí v hlavičce X-API-Version. Nekompatibilní změny se zavádějí pod novou cestou, tato cesta se nemění. Koncový bod v1 nebude vypnut bez hlavičky Deprecation odeslané nejméně 90 dní předem, v souladu s RFC 8594.
Strojově čitelná specifikace
Úplný dokument OpenAPI 3.1 je k dispozici na /api/docs. Nasměrujte na něj přímo Postman, Swagger UI nebo generátor klienta, místo abyste tuto stránku opisovali.
https://polads.eu/api/docs