Dokumentacija API za SSP
API platforme na strani ponudbe za platforme programatičnega oglaševanja
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 zahtev na minuto
Omejitev števila zahtev velja za posamezen žeton SSP
/online-advertisement/{PAID}📊 Kompaktna oblika oznake
Ta končna točka vrne kompaktno oznako preglednosti, skladno s predpisi EU, ki je primerna za prikaz ob spletnih oglasih. Deluje samo za oglase z medijem = "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 oznako na svoji platformi:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Oblika glave
Authorization: Bearer YOUR_SSP_TOKENOblika žetona
64-mestni šestnajstiški niz (256-bitna entropija)
Upravljanje žetonov
Žetone SSP upravljajo samo sistemski skrbniki. Za pridobitev žetona se obrnite na svojega skrbnika.
Noben naročniški paket ne velja
Žeton SSP se izda integratorju in ne izdajatelju, zato ni povezan z nobenim računom izdajatelja in ni paketa, ki bi ga bilo treba preveriti. Za razliko od partnerskega API tukaj nič ni odvisno od naročnine. Partnerski žeton je na tej končni točki zavrnjen s kodo 401, žeton SSP pa je na enak način zavrnjen na partnerskih končnih točkah.
Kdaj končna točka vrne 404
Obvestilo se poišče po istem pravilu vidnosti kot v javnem registru. Obvestilo, ki še ni potrjeno, ki ga njegov izdajatelj še ni odobril ali katerega datum začetka objave je še v prihodnosti, vrne 404. Koda 404 torej ni dokaz, da je PA-ID napačen.
Zgornja končna točka vrne enovrstično BESEDILO oznake za oznako, ki jo izriše vaša lastna platforma. Oznaka preglednosti vrne izrisano, interaktivno obvestilo, ki ga kot vgrajeni okvir postavite ob oglas. Obe opisujeta isto obvestilo o preglednosti.
En URL za vsako različico
Vsak upravljalni element v predstavitvi ustreza natanko enemu od teh parametrov, zato lahko izbirate na predstavitveni strani in kopirate prikazani URL.
# Kotna oznaka, samo znak
GET https://polads.eu/badge/{PA-ID}
# Kotna oznaka z besedilom
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Vedno viden trak z oznako
GET https://polads.eu/badge/{PA-ID}?layout=labelKaj počne vsak parameter in kaj pomeni, če ga izpustite
layout=label izbere trak. Če ga izpustite, se prikaže kotna oznaka. variant=labelled na zaprti oznaki prikaže besedilo. Če ga izpustite, se prikaže samo znak. w in h določata prostor, v katerem je oznaka, in izbereta, kako se oznaka prilagodi v tesnem prostoru. Če ju izpustite, oznaka predpostavi, da ima dovolj prostora, kar je pravilno za standardne formate.
hover=0 je za predstavitev, ne za vašo stran
Vsili postavitev brez kazalca, da lahko predstavitev v namiznem brskalniku pokaže različico za zaslone na dotik. Prava oznaka napravo preveri sama. Če vrednost trdno nastavite, pošljete napačno različico vsakemu obiskovalcu, katerega naprava je drugačna.
Poslušalec spremembe velikosti je obvezen
Kotna oznaka se naloži v velikosti 32 krat 32, da prekrije čim manj oglasnega gradiva, ob odprtju pa gostiteljsko stran zaprosi za prostor. Brez poslušalca se sploh ne more odpreti. Trak z oznako se prilagodi bolj postopno in se obreže le pri majhnih širinah.
Na voljo le za objavljeno obvestilo
Oznaka se prikaže, ko je obvestilo potrjeno, ko ga je izdajatelj odobril in ko je minil datum začetka objave. PA-ID pod embargom ali brez odobritve namenoma vrne 404, to ni posledica napake.
Odprite interaktivno predstavitev in kopirajte kodo za vgradnjo
401 Nepooblaščeno
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Neveljavna zahteva
Oglas je bil najden, vendar njegov medij ni online. Odziv vrne dejansko vrednost medija, na primer print. Manjkajoč ali neznan PA-ID namesto tega vrne 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Ni najdeno
{
"error": "Advertisement not found"
}429 Presežena omejitev števila zahtev
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}To je različica API v1, kar vsak odziv navede v glavi X-API-Version. Nezdružljive spremembe se objavijo na novi poti, ta pa ostane nespremenjena. Končna točka v1 ne bo izklopljena, ne da bi bila vsaj 90 dni prej poslana glava Deprecation, skladno z RFC 8594.
Strojno berljiva specifikacija
Celoten dokument OpenAPI 3.1 je na voljo na /api/docs. Postman, Swagger UI ali generator odjemalcev usmerite neposredno nanj, namesto da prepisujete to stran.
https://polads.eu/api/docs