Doiciméadú API SSP

URL amháin do gach leagan

Freagraíonn gach rialtán sa taispeántas do pharaiméadar amháin díobh seo, mar sin is féidir leat do rogha a dhéanamh ar leathanach an taispeántais agus an URL a fheiceann tú a chóipeáil.

# Suaitheantas cúinne, an marc amháin
GET https://polads.eu/badge/{PA-ID}

# Suaitheantas cúinne a thaispeánann a théacs
GET https://polads.eu/badge/{PA-ID}?variant=labelled

# Stiall lipéid a bhíonn le feiceáil i gcónaí
GET https://polads.eu/badge/{PA-ID}?layout=label

Cad a dhéanann gach paraiméadar, agus cad is brí lena fhágáil ar lár

Roghnaíonn layout=label an stiall. Fág ar lár é chun an suaitheantas cúinne a fháil. Le variant=labelled taispeánann an suaitheantas dúnta a théacs. Fág ar lár é chun an marc amháin a fháil. Dearbhaíonn w agus h an spás ina suíonn an suaitheantas agus socraíonn siad conas a oiriúnaíonn sé do spás cúng. Fág ar lár iad agus 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é an leagan amach gan foluain i bhfeidhm ionas gur féidir leis an taispeántas an leagan tadhaill a thaispeáint i mbrabhsálaí deisce. Seiceálann an fíor-shuaitheantas an gléas é féin. Má shocraíonn tú an luach go buan, seolfaidh tú an leagan mícheart chuig gach cuairteoir nach n-oireann a ghléas don socrú sin.

Tá gá leis an éisteoir athraithe méide

Lódálann an suaitheantas cúinne ag 32 faoi 32 ionas go gclúdaíonn sé an méid is lú is féidir den ábhar cruthaitheach, agus ansin iarrann sé spás ar an leathanach óstach nuair a osclaíonn sé. Gan an t-éisteoir ní féidir leis oscailt ar chor ar bith. Oiriúnaíonn an stiall lipéid níos séimhe, agus ní bhearrtar í ach nuair atá an leithead cúng.

Ar fáil d’fhógra foilsithe amháin

Seirbheáiltear an suaitheantas a luaithe atá an fógra deimhnithe, faofa ag an bhfoilsitheoir agus a dháta tosaigh foilsithe caite. Tugann PA-ID atá faoi lánchosc nó nár síníodh 404 ar ais d’aon ghnó, ní de bharr locht.

401 Gan údar

{
  "error": "Invalid or revoked SSP API token."
}

{
  "error": "Missing or invalid Authorization header. Expected: Bearer <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.

{
  "error": "This endpoint is only for online advertisements",
  "medium": "print"
}

404 Gan Aimsiú

{
  "error": "Advertisement not found"
}

429 Sáraíodh an Teorainn Ráta

{
  "error": "Rate limit exceeded",
  "limit": 10000,
  "remaining": 0,
  "reset": "2026-05-14T15:14:00.000Z"
}