SSP Doiciméadúchán API
API ardáin ar thaobh an tsoláthair d’ardáin fógraíochta ríomhchláraithe
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10,000 iarratas in aghaidh an nóiméid
Teorainn an ráta curtha i bhfeidhm in aghaidh an chomhartha SSP
/online-advertisement/{PAID}📊 Formáid Dlúth Lipéad
Cuireann an críochphointe seo lipéad trédhearcachta dlúth-chomhlíontach leis an AE ar ais agus atá oiriúnach le taispeáint taobh le fógraí ar líne. Ní oibríonn ach le haghaidh fógraí le medium = "ar líne".
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"
}Taispeáin an lipéad ar d’ardán:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formáid Cheanntásc
Authorization: Bearer YOUR_SSP_TOKENFormáid Chomhartha
64-charachtar teaghrán heicsidheachúlach (eantrópachta 256-giotán)
Bainistíocht Chomhartha Is iad riarthóirí córais amháin a bhainistíonn comharthaí
SSP. Déan teagmháil le do riarthóir chun comhartha a fháil.
Ní bhaineann aon phlean leis
Eisítear comhartha SSP chuig comhtháthóir seachas chuig foilsitheoir, mar sin ní bhaineann sé le haon chuntas foilsitheora agus níl aon phlean le seiceáil. Murab ionann agus an API comhpháirtíochta, níl aon rud anseo ag brath ar shíntiús. Diúltaítear do chomhartha comhpháirtí ar an gcríochphointe seo le 401, agus diúltaítear do chomhartha SSP ar na críochphointí comhpháirtíochta ar an gcaoi chéanna.
Cathain a thugann an críochphointe 404 ar ais
Réitítear an fógra leis an riail infheictheachta chéanna leis an gclár poiblí. Fógra nach bhfuil deimhnithe fós, nár cheadaigh an foilsitheoir fós, nó a bhfuil dáta tosaithe a fhoilsithe fós amach anseo, tugann sé 404 ar ais. Mar sin ní cruthúnas é 404 go bhfuil PA-ID mícheart.
Tugann an críochphointe thuas téacs an lipéid ar líne amháin ar ais, do lipéad a tharraingíonn do rian féin. Tugann an comhartha fógra idirghníomhach réamhdhéanta ar ais, a chuireann tú in aice leis an bhfógra i bhfráma. Cuireann an dá cheann síos ar an bhfógra trédhearcachta céanna.
URL amháin in aghaidh gach leagain
Freagraíonn rialtáin an taispeántais do na paraiméadair seo duine ar dhuine, mar sin is féidir leat rogha a dhéanamh ar an leathanach taispeántais agus an URL a fheiceann tú a chóipeáil.
# Suaitheantas cúinne, an mharc amháin
GET https://polads.eu/badge/{PA-ID}
# Suaitheantas cúinne lena théacs
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Stiall lipéadaithe atá le feiceáil i gcónaí
GET https://polads.eu/badge/{PA-ID}?layout=labelCad a dhéanann gach paraiméadar, agus cad is brí lena fhágáil ar lár
Roghnaíonn layout=label an stiall, agus gan é faightear an suaitheantas cúinne. Taispeánann variant=labelled an téacs ar an suaitheantas dúnta, agus gan é ní fhanann ach an mharc. Dearbhaíonn w agus h an spás ina suíonn an suaitheantas agus socraíonn siad conas a chuireann sé in oiriúint nuair atá an spás gann. Má fhágtar ar lár iad, glacann an suaitheantas leis go bhfuil spás aige, rud atá ceart do na formáidí caighdeánacha.
Is don taispeántas é hover=0, ní do do leathanach
Cuireann sé iallach ar an amharc gan ainlíu, ionas gur féidir leis an taispeántas an leagan tadhaill a thaispeáint i mbrabhsálaí deisce. Déanann an fíor-shuaitheantas an gléas a sheiceáil é féin. Má dhaingníonn tú é, seolann tú an leagan mícheart chuig gach cuairteoir a bhfuil a ghléas ag rá a mhalairt.
Tá gá leis an éisteoir athraithe méide
Lódálann comhartha an chúinne ag 32 faoi 32 ionas go gclúdaíonn sé an méid is lú is féidir den chruthaíocht, agus ansin iarrann sé spás ar an leathanach nuair a osclaíonn sé. Gan an t-éisteoir ní féidir leis oscailt ar chor ar bith. Tá an stráice níos foighní agus ní bhearrtar é ach ar leithid chúnga.
Ar fáil d’fhógra foilsithe amháin
Seirbheáiltear an comhartha nuair atá an fógra deimhnithe, faofa ag an bhfoilsitheoir agus a dháta tosaigh caite. Freagraíonn PA-ID faoi lánchosc nó gan faomhadh le 404 d’aon ghnó, ní de bharr fabht.
Oscail an taispeántas idirghníomhach agus cóipeáil an cód leabaithe
401 Gan údar
{ "error": "Invalid or revoked SSP API token." }400 Iarratas neamhbhailí
Fuarthas an fógra, ach níl a mheán online. Cuireann an freagra fíorluach an mheáin ar ais, mar shampla print. Cuireann PA-ID atá ar iarraidh nó anaithnid 404 ar ais ina ionad.
404 Gan Aimsiú
{ "error": "Advertisement not found" }429 Teorainn Ráta os cionn
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30:00.000Z"
}Is é seo leagan API v1, agus deir gach freagra é sin i gceanntásc X-API-Version. Foilsítear athruithe briseadh ar chosán nua seachas an ceann seo a athrú. Ní mhúchfar críochphointe v1 gan ceanntásc Deprecation ar a laghad 90 lá roimh ré, de réir RFC 8594.
Sonraíocht inléite ag meaisín
Freastalaítear an doiciméad iomlán OpenAPI 3.1 ag /api/docs. Dírigh Postman, Swagger UI nó gineadóir cliaint díreach air sin seachas an leathanach seo a athscríobh.
https://polads.eu/api/docs