Dokumentazzjoni tal-API SSP
API ta’ pjattaforma tan-naħa tal-provvista għal pjattaformi ta’ reklamar programmatiku
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 talba kull minuta
Il-limitu tar-rata jiġi applikat għal kull token SSP
/online-advertisement/{PAID}📊 Format kompatt tat-tikketta
Dan l-endpoint jirritorna tikketta ta' trasparenza kompatta u konformi mar-regoli tal-UE, adattata biex tintwera ħdejn reklami online. Jaħdem biss għal reklami li l-mezz tagħhom huwa "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"
}Uri t-tikketta fuq il-pjattaforma tiegħek:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Format tal-intestatura
Authorization: Bearer YOUR_SSP_TOKENFormat tat-token
Sekwenza eżadeċimali ta’ 64 karattru (entropija ta’ 256 bit)
Ġestjoni tat-tokens
It-tokens SSP jiġu ġestiti biss mill-amministraturi tas-sistema. Ikkuntattja lill-amministratur tiegħek biex tikseb token.
L-ebda pjan ta’ abbonament ma japplika
Token SSP jinħareġ lil integratur u mhux lil pubblikatur, għalhekk ma jappartjeni għall-ebda kont ta’ pubblikatur u m’hemm l-ebda pjan x’jiġi vverifikat. B’differenza mill-API tas-sħab, hawn xejn ma jiddependi minn abbonament. Token ta’ sieħeb jiġi rrifjutat f’dan l-endpoint b’401, u token SSP jiġi rrifjutat bl-istess mod fl-endpoints tas-sħab.
Meta l-endpoint jirritorna 404
L-avviż jiġi determinat bl-istess regola ta’ viżibilità bħar-reġistru pubbliku. Avviż li għadu mhux ikkonfermat, li l-pubblikatur tiegħu għadu ma approvahx, jew li d-data tal-bidu tal-pubblikazzjoni tiegħu għadha fil-futur, jirritorna 404. Għalhekk 404 mhuwiex prova li PA-ID huwa żbaljat.
L-endpoint ta’ hawn fuq jirritorna t-TEST tat-tikketta fuq linja waħda, għal tikketta li tpinġi l-pjattaforma tiegħek stess. Il-marka tirritorna avviż interattiv lest, li tqiegħed ħdejn ir-reklam f’qafas. It-tnejn jiddeskrivu l-istess avviż ta’ trasparenza.
URL wieħed għal kull verżjoni
Il-kontrolli tad-dimostrazzjoni jaqblu ma’ dawn il-parametri wieħed b’wieħed, għalhekk tista’ tagħżel fil-paġna tad-dimostrazzjoni u tikkopja l-URL li tara.
# Marka tal-kantuniera, is-simbolu biss
GET https://polads.eu/badge/{PA-ID}
# Marka tal-kantuniera bil-kliem tagħha
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Strixxa tat-tikketta li tidher dejjem
GET https://polads.eu/badge/{PA-ID}?layout=labelX'jagħmel kull parametru, u xi jfisser jekk tħallih barra
layout=label jagħżel il-faxxa. Jekk tħallih barra, tieħu l-marka tal-kantuniera. variant=labelled iġiegħel lill-marka magħluqa turi l-kliem tagħha. Jekk tħallih barra, tieħu s-simbolu waħdu. w u h jiddikjaraw l-ispazju fejn tinsab il-marka u jagħżlu kif tadatta f'spazju dejjaq. Jekk tħallihom barra, il-marka tassumi li għandha biżżejjed spazju, u dan huwa korrett għall-formati standard.
hover=0 huwa għad-dimostrazzjoni, mhux għall-paġna tiegħek
Jġiegħel it-tqassim għal apparati mingħajr maws, biex id-dimostrazzjoni tkun tista' turi l-verżjoni għall-iskrin tal-mess fuq kompjuter. Il-marka vera tivverifika l-apparat waħedha. Jekk tiffissah fil-kodiċi, tibgħat il-verżjoni żbaljata lil kull viżitatur li l-apparat tiegħu ma jaqbilx.
Is-semmiegħ tad-daqs huwa meħtieġ
Il-marka tal-kantuniera titgħabba f'32 b'32 biex tkopri l-inqas possibbli mill-kontenut tar-reklam, imbagħad titlob spazju lill-paġna ospitanti meta tinfetaħ. Mingħajr is-semmiegħ ma tistax tinfetaħ xejn. Il-faxxa tat-tikketta tadatta b'mod aktar ġentili, u tinqata' biss f'wisgħat dojoq.
Disponibbli biss għal avviż ippubblikat
Il-marka tiġi pprovduta ladarba l-avviż ikun ikkonfermat, approvat mill-pubblikatur u tkun għaddiet id-data tal-bidu tal-pubblikazzjoni tiegħu. PA-ID taħt embargo jew mhux approvat iwieġeb 404 apposta, mhux minħabba xi żball.
Iftaħ id-dimostrazzjoni interattiva u kkopja l-kodiċi għall-inkorporazzjoni
401 Mhux awtorizzat
{
"error": "Invalid or revoked SSP API token."
}{
"error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}400 Talba invalida
Ir-reklam instab, iżda l-mezz tiegħu mhuwiex online. It-tweġiba tirritorna l-valur reali tal-mezz, pereżempju print. PA-ID nieqes jew mhux magħruf minflok jirritorna 404.
{
"error": "This endpoint is only for online advertisements",
"medium": "print"
}404 Ma nstabx
{
"error": "Advertisement not found"
}429 Inqabeż il-limitu tar-rata
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2026-05-14T15:14:00.000Z"
}Din hija l-verżjoni API v1, u kull tweġiba tgħid dan f'intestatura X-API-Version. Bidliet li jkissru l-kompatibbiltà joħorġu taħt mogħdija ġdida minflok ma jibdlu din. Punt finali v1 mhux se jintefa mingħajr intestatura Deprecation mill-inqas 90 jum qabel, skont RFC 8594.
Speċifikazzjoni li tinqara mill-magni
Id-dokument OpenAPI 3.1 sħiħ huwa disponibbli fuq /api/docs. Ipponta lil Postman, Swagger UI jew ġeneratur ta' klijenti direttament lejh minflok ma tikkopja din il-paġna.
https://polads.eu/api/docs