SSP API dokumentacija
API platforme na strani ponude za platforme za programatsko oglašavanje
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 zahtjeva u minuti
Ograničenje brzine primjenjuje se po SSP tokenu
/online-advertisement/{PAID}📊 Kompaktni format oznake
Ova krajnja točka vraća kompaktnu oznaku transparentnosti usklađenu s pravom EU-a, prikladnu za prikaz uz internetske oglase. Radi samo za oglase kod kojih je 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"
}Prikažite oznaku na svojoj platformi:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Format zaglavlja
Authorization: Bearer YOUR_SSP_TOKENFormat tokena
Heksadecimalni niz od 64 znaka (entropija od 256 bitova)
Upravljanje tokenima
SSP tokenima upravljaju samo administratori sustava. Obratite se svom administratoru da biste dobili token.
Ne primjenjuje se nijedan pretplatnički plan
SSP token izdaje se integratoru, a ne izdavaču, pa nije povezan ni s jednim računom izdavača i nema plana koji bi se provjeravao. Za razliku od partnerskog API-ja, ovdje ništa ne ovisi o pretplati. Partnerski token na ovoj se krajnjoj točki odbija s kodom 401, a SSP token na isti se način odbija na partnerskim krajnjim točkama.
Kada krajnja točka vraća 404
Obavijest se dohvaća prema istom pravilu vidljivosti kao i u javnom registru. Obavijest koja još nije potvrđena, koju njezin izdavač još nije odobrio ili čiji je datum početka objave još u budućnosti vraća 404. Odgovor 404 stoga nije dokaz da je PA-ID pogrešan.
Gornja krajnja točka vraća jednoredni TEKST oznake, za oznaku koju iscrtava vaša vlastita platforma. Oznaka vraća gotovu, interaktivnu obavijest koju postavljate uz oglas u ugrađenom okviru. Oba prikaza opisuju istu obavijest o transparentnosti.
Jedan URL po verziji
Upravljački elementi demonstracije odgovaraju ovim parametrima jedan prema jedan, pa možete odabrati na stranici s demonstracijom i kopirati adresu koju vidite.
# Kutna oznaka, samo znak
GET https://polads.eu/badge/{PA-ID}
# Kutna oznaka s prikazanim tekstom
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Stalno vidljiva traka s oznakom
GET https://polads.eu/badge/{PA-ID}?layout=labelŠto radi pojedini parametar i što znači ako ga izostavite
layout=label odabire traku. Bez njega se prikazuje kutna oznaka. variant=labelled prikazuje tekst na zatvorenoj oznaci. Bez njega se prikazuje samo znak. w i h navode prostor u kojem se oznaka nalazi i određuju kako se ona prilagođava kada je prostora malo. Ako ih izostavite, oznaka pretpostavlja da ima dovoljno prostora, što je ispravno za standardne formate.
hover=0 služi za demonstraciju, a ne za vašu stranicu
Nameće prikaz bez lebdenja pokazivača kako bi demonstracija mogla prikazati verziju za dodirne zaslone u stolnom pregledniku. Prava oznaka sama provjerava uređaj. Ako tu vrijednost fiksno postavite, svakom posjetitelju čiji se uređaj s njom ne slaže šaljete pogrešnu verziju.
Slušatelj promjene veličine je obavezan
Kutna oznaka učitava se u veličini 32 puta 32 kako bi prekrila što manji dio oglasnog materijala, a zatim pri otvaranju traži od stranice domaćina više prostora. Bez slušatelja uopće se ne može otvoriti. Traka s oznakom prilagođava se blaže i odrezuje se samo pri malim širinama.
Dostupno samo za objavljenu obavijest
Oznaka se poslužuje nakon što je obavijest potvrđena, nakon što ju je izdavač odobrio i nakon što je prošao datum početka objave. Za PA-ID pod embargom ili bez odobrenja odgovor 404 vraća se namjerno, a ne zbog pogreške.
Otvorite interaktivnu demonstraciju i kopirajte kod za ugradnju
401 Neovlašteno
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Neispravan zahtjev
Oglas je pronađen, ali njegov medij nije online. Odgovor vraća stvarnu vrijednost medija, primjerice print. PA-ID koji nedostaje ili je nepoznat umjesto toga vraća 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Nije pronađeno
{
"error": "Advertisement not found"
}429 Prekoračeno ograničenje brzine
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Ovo je verzija API v1, a svaki odgovor to navodi u zaglavlju X-API-Version. Nekompatibilne promjene izlaze na novoj putanji umjesto da mijenjaju ovu. Krajnja točka v1 neće biti isključena bez zaglavlja Deprecation najmanje 90 dana unaprijed, u skladu s RFC 8594.
Strojno čitljiva specifikacija
Cjeloviti dokument OpenAPI 3.1 poslužuje se na /api/docs. Usmjerite Postman, Swagger UI ili generator klijenta izravno onamo umjesto da prepisujete ovu stranicu.
https://polads.eu/api/docs