Документация за SSP API
API на платформата от страната на предлагането (SSP) за програматични рекламни платформи
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10 000 заявки в минута
Ограничението се прилага поотделно за всеки SSP токен
/online-advertisement/{PAID}📊 Компактен формат на етикета
Тази крайна точка връща компактен етикет за прозрачност в съответствие с правото на ЕС, подходящ за показване до онлайн реклами. Работи само за реклами с носител = "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"
}Покажете етикета на вашата платформа:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Формат на заглавката
Authorization: Bearer YOUR_SSP_TOKENФормат на токена
64-знаков шестнадесетичен низ (256-битова ентропия)
Управление на токени
SSP токените се управляват само от системни администратори. Свържете се с вашия администратор, за да получите токен.
Не се прилага абонаментен план
SSP токен се издава на интегратор, а не на издател, затова не е свързан с издателски профил и няма план за проверка. За разлика от партньорския API тук нищо не зависи от абонамент. Партньорски токен се отхвърля на тази крайна точка с код 401, а SSP токен се отхвърля по същия начин на партньорските крайни точки.
Кога крайната точка връща 404
Обявлението се намира по същото правило за видимост като публичния регистър. Обявление, което още не е потвърдено, което издателят му още не е одобрил или чиято начална дата на публикуване е още в бъдещето, връща 404. Затова кодът 404 не доказва, че PA-ID е грешен.
Горната крайна точка връща едноредовия ТЕКСТ на етикета, за етикет, който изобразява вашата собствена платформа. Значката връща готово интерактивно обявление, което поставяте до рекламата като вградена рамка. И двете описват едно и също обявление за прозрачност.
По един URL адрес за всяка версия
Бутоните в демонстрацията съответстват едно към едно на тези параметри, така че можете да изберете в демонстрационната страница и да копирате показания адрес.
# Ъглова значка, само знакът
GET https://polads.eu/badge/{PA-ID}
# Ъглова значка с надпис
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Постоянно видима лента с обозначение
GET https://polads.eu/badge/{PA-ID}?layout=labelКакво прави всеки параметър и какво означава да го пропуснете
layout=label избира лентата. Без него се показва ъгловата значка. variant=labelled показва надписа върху затворената значка. Без него остава само знакът. w и h определят мястото, в което стои значката, и избират как тя се приспособява при малко място. Ако ги пропуснете, значката приема, че има достатъчно място, което е правилно за стандартните формати.
hover=0 е за демонстрацията, а не за вашата страница
Той налага оформлението без задържане на курсора, за да може демонстрацията да покаже версията за сензорни екрани в настолен браузър. Истинската значка сама проверява устройството. Ако фиксирате стойността, ще изпращате грешната версия на всеки посетител, чието устройство е различно.
Слушателят за преоразмеряване е задължителен
Ъгловата значка се зарежда в размер 32 на 32, за да покрива възможно най-малко от рекламното съдържание, и при отваряне иска място от страницата домакин. Без слушателя тя изобщо не може да се отвори. Лентата с обозначение се приспособява по-плавно и се отрязва само при малка ширина.
Достъпно само за публикувано обявление
Значката се предоставя, след като обявлението е потвърдено, одобрено от издателя и началната му дата на публикуване е настъпила. PA-ID под ембарго или без одобрение връща 404 умишлено, а не поради грешка.
Отворете интерактивната демонстрация и копирайте кода за вграждане
401 Неразрешено
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Невалидна заявка
Обявата е намерена, но носителят ѝ не е online. Отговорът връща действителната стойност на носителя, например print. Липсващ или непознат PA-ID връща 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Не е намерено
{
"error": "Advertisement not found"
}429 Превишено ограничение на скоростта
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Това е версия v1 на API и всеки отговор го посочва в заглавка X-API-Version. Несъвместимите промени се публикуват на нов път, вместо да променят този. Крайна точка v1 няма да бъде изключена без заглавка Deprecation поне 90 дни предварително, съгласно RFC 8594.
Машинно четима спецификация
Пълният документ OpenAPI 3.1 е достъпен на /api/docs. Насочете Postman, Swagger UI или генератор на клиенти директно към него, вместо да преписвате тази страница.
https://polads.eu/api/docs