SSP API dokumentācija
Piedāvājuma puses platformas API programmatiskās reklāmas platformām
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 pieprasījumu minūtē
Pieprasījumu biežuma ierobežojums tiek piemērots katrai SSP pilnvarai
/online-advertisement/{PAID}📊 Kompakts marķējuma formāts
Šis galapunkts atgriež kompaktu, ES prasībām atbilstošu pārredzamības marķējumu, kas piemērots rādīšanai blakus tiešsaistes reklāmām. Darbojas tikai reklāmām, kurām medijs = "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"
}Parādiet marķējumu savā platformā:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Galvenes formāts
Authorization: Bearer YOUR_SSP_TOKENPilnvaras formāts
64 rakstzīmju heksadecimāla virkne (256 bitu entropija)
Pilnvaru pārvaldība
SSP pilnvaras pārvalda tikai sistēmas administratori. Lai iegūtu pilnvaru, sazinieties ar savu administratoru.
Abonēšanas plāns netiek piemērots
SSP pilnvaru izsniedz integratoram, nevis izdevējam, tāpēc tā nav piesaistīta izdevēja kontam un nav plāna, ko pārbaudīt. Atšķirībā no partneru API šeit nekas nav atkarīgs no abonementa. Partnera pilnvara šajā galapunktā tiek noraidīta ar kodu 401, un SSP pilnvara tāpat tiek noraidīta partneru galapunktos.
Kad galapunkts atgriež 404
Paziņojums tiek atrasts pēc tā paša redzamības noteikuma kā publiskajā reģistrā. Paziņojums, kas vēl nav apstiprināts, ko izdevējs vēl nav parakstījis vai kura publicēšanas sākuma datums vēl ir nākotnē, atgriež 404. Tādēļ kods 404 nepierāda, ka PA-ID ir nepareizs.
Iepriekš minētais galapunkts atgriež vienas rindas marķējuma TEKSTU marķējumam, ko attēlo jūsu pašu platforma. Zīme atgriež gatavu, interaktīvu paziņojumu, ko iegultā rāmī novietojat blakus reklāmai. Abi apraksta vienu un to pašu pārredzamības paziņojumu.
Viens URL katrai versijai
Demonstrācijas vadīklas atbilst šiem parametriem viens pret vienu, tāpēc varat izvēlēties demonstrācijas lapā un nokopēt redzamo adresi.
# Stūra zīme, tikai simbols
GET https://polads.eu/badge/{PA-ID}
# Stūra zīme ar uzrakstu
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Pastāvīgi redzama marķējuma josla
GET https://polads.eu/badge/{PA-ID}?layout=labelKo dara katrs parametrs un ko nozīmē to izlaist
layout=label izvēlas joslu. Ja to izlaižat, tiek rādīta stūra zīme. variant=labelled liek aizvērtajai zīmei rādīt uzrakstu. Ja to izlaižat, tiek rādīta tikai zīme. w un h norāda vietu, kurā zīme atrodas, un nosaka, kā tā vienkāršojas šaurā vietā. Ja tos izlaižat, zīme pieņem, ka vietas pietiek, un tas ir pareizi standarta formātiem.
hover=0 ir domāts demonstrācijai, nevis jūsu lapai
Tas piespiedu kārtā ieslēdz izkārtojumu bez kursora, lai demonstrācija datora pārlūkā varētu parādīt skārienekrāna versiju. Īstā zīme ierīci pārbauda pati. Ja šo vērtību nostiprināsiet kodā, katrs apmeklētājs, kura ierīce neatbilst šim pieņēmumam, saņems nepareizo versiju.
Izmēra maiņas klausītājs ir obligāts
Stūra zīme ielādējas 32 reiz 32 izmērā, lai pēc iespējas mazāk aizsegtu reklāmas materiālu, un, atveroties, lūdz mitinātājlapai vietu. Bez klausītāja tā vispār nevar atvērties. Marķējuma josla šaurā vietā vienkāršojas saudzīgāk un tiek apgriezta tikai nelielos platumos.
Pieejama tikai publicētam paziņojumam
Zīme tiek piegādāta, kad paziņojums ir apstiprināts, izdevējs to ir akceptējis un ir pienācis tā publicēšanas sākuma datums. PA-ID, uz kuru attiecas embargo vai kas nav akceptēts, apzināti atgriež 404, un tā nav kļūda.
Atveriet interaktīvo demonstrāciju un kopējiet iegulšanas kodu
401 Nesankcionēts
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Nederīgs pieprasījums
Sludinājums tika atrasts, bet tā medijs nav online. Atbilde atgriež faktisko medija vērtību, piemēram, print. Trūkstošs vai nezināms PA-ID atgriež 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Nav atrasts
{
"error": "Advertisement not found"
}429 Pārsniegts pieprasījumu limits
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Šī ir API versija v1, un katra atbilde to norāda galvenē X-API-Version. Saderību lauzošas izmaiņas tiek ieviestas jaunā ceļā, nevis mainot šo. Versijas v1 galapunkts netiks izslēgts, ja vismaz 90 dienas iepriekš nebūs sniegta galvene Deprecation saskaņā ar RFC 8594.
Mašīnlasāma specifikācija
Pilns OpenAPI 3.1 dokuments ir pieejams adresē /api/docs. Norādiet Postman, Swagger UI vai klienta ģeneratoram tieši šo adresi, nevis pārrakstiet šo lapu.
https://polads.eu/api/docs