SSP API-dokumentáció
Kínálati oldali platformok API-ja programmatikus hirdetési platformok számára
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 kérés percenként
A kérésszám-korlát SSP-tokenenként érvényes
/online-advertisement/{PAID}📊 Kompakt címkeformátum
Ez a végpont kompakt, az uniós előírásoknak megfelelő átláthatósági címkét ad vissza, amely online hirdetések mellett jeleníthető meg. Csak a medium = "online" értékű hirdetéseknél működik.
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"
}Jelenítse meg a címkét a saját platformján:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Fejlécformátum
Authorization: Bearer YOUR_SSP_TOKENTokenformátum
64 karakteres hexadecimális karakterlánc (256 bites entrópia)
Tokenkezelés
Az SSP-tokeneket kizárólag a rendszergazdák kezelik. Token igényléséhez forduljon a rendszergazdájához.
Nem vonatkozik rá előfizetési csomag
Az SSP-tokent integrátor kapja, nem kiadó, ezért nem tartozik hozzá kiadói fiók, és nincs ellenőrizendő csomag. A partner API-val ellentétben itt semmi sem függ előfizetéstől. Ez a végpont a partnertokent 401-es kóddal elutasítja, és a partnervégpontok ugyanígy elutasítják az SSP-tokent.
Mikor ad vissza a végpont 404-et
A közleményt ugyanazzal a láthatósági szabállyal keressük ki, mint a nyilvános nyilvántartásban. 404-et ad vissza az a közlemény, amelyet még nem erősítettek meg, amelyet a kiadója még nem hagyott jóvá, vagy amelynek közzétételi kezdőnapja még a jövőben van. A 404 tehát nem bizonyítja, hogy a PA-ID hibás.
A fenti végpont az egysoros címke szövegét adja vissza olyan címkéhez, amelyet a saját platformja jelenít meg. A jelvény kész, interaktív közleményt ad vissza, amelyet beágyazott keretként (iframe) helyez el a hirdetés mellett. Mindkettő ugyanazt az átláthatósági közleményt írja le.
Verziónként egy URL
A bemutató kezelőelemei egy az egyben megfelelnek ezeknek a paramétereknek, így a bemutatóoldalon kiválaszthatja a kívánt változatot, és kimásolhatja a megjelenő URL-t.
# Sarokjelvény, csak a jelzés
GET https://polads.eu/badge/{PA-ID}
# Sarokjelvény felirattal
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Mindig látható jelölősáv
GET https://polads.eu/badge/{PA-ID}?layout=labelMire szolgálnak az egyes paraméterek, és mi történik, ha kihagyja őket
A layout=label a sávot választja ki. Ha kihagyja, a sarokjelvény jelenik meg. A variant=labelled hatására a zárt jelvény a feliratát is mutatja. Ha kihagyja, csak a jelzés látszik. A w és a h megadja a helyet, amelyben a jelvény elhelyezkedik, és meghatározza, hogyan alkalmazkodik szűk helyen. Ha kihagyja őket, a jelvény abból indul ki, hogy elegendő helye van, ami a szabványos formátumoknál helytálló.
A hover=0 a bemutatóhoz készült, ne használja a saját oldalán
Kikényszeríti az egérmutató nélküli elrendezést, hogy a bemutató asztali böngészőben is megmutathassa az érintőképernyős változatot. A valódi jelvény maga vizsgálja meg az eszközt. Ha rögzíti az értéket, minden olyan látogatónak rossz változatot küld, akinek az eszköze ettől eltér.
Az átméretezési eseményfigyelő kötelező
A sarokjelvény 32-szer 32-es méretben töltődik be, hogy a lehető legkevesebbet takarja el a kreatívból, majd megnyitáskor helyet kér a befogadó oldaltól. Az eseményfigyelő nélkül egyáltalán nem tud megnyílni. A jelölősáv kíméletesebben alkalmazkodik, és csak keskeny szélességnél vágódik le.
Csak közzétett közleményhez érhető el
A jelvényt akkor szolgáljuk ki, amikor a közleményt megerősítették, a kiadó jóváhagyta, és a közzététel kezdő dátuma már elmúlt. A közzétételi tilalom alatt álló vagy jóvá nem hagyott PA-ID szándékosan, nem hiba miatt ad 404-et.
Nyissa meg az interaktív bemutatót, és másolja ki a beágyazási kódot
401 Jogosulatlan
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Hibás kérés
A hirdetés megvan, de a médiuma nem online. A válasz a tényleges médiumértéket adja vissza, például print. A hiányzó vagy ismeretlen PA-ID helyette 404-et ad.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Nem található
{
"error": "Advertisement not found"
}429 Kéréskorlát túllépve
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Ez az API v1-es verziója, és ezt minden válasz jelzi az X-API-Version fejlécben. A visszafelé nem kompatibilis változások új útvonalon jelennek meg, ez az útvonal nem változik. Egy v1-es végpontot csak akkor kapcsolunk ki, ha legalább 90 nappal előtte Deprecation fejlécet küldünk, az RFC 8594 szerint.
Géppel olvasható specifikáció
A teljes OpenAPI 3.1 dokumentum a /api/docs címen érhető el. Irányítsa a Postmant, a Swagger UI-t vagy egy klienskódgenerátort közvetlenül oda, ahelyett hogy ezt az oldalt másolná át.
https://polads.eu/api/docs