Għall-iżviluppaturi

API pubbliku

API żgħir, JSON u read-only li jesponi d-data ppubblikata ta' Elezzjoni — partiti, distretti elettorali u kandidati. Ma jeħtieġx API key.

Format

JSON

Awtentikazzjoni

L-ebda

CORS

Limitu ta' talbiet

Biex inżommu s-servizz responsiv għal kulħadd, l-endpoints pubbliċi huma limitati skont l-IP tal-klijent.

60 talbiet kull minuta għal kull IP, għal kull endpoint
Kull risposta tinkludi l-headers X-RateLimit-Limit, X-RateLimit-Remaining u X-RateLimit-Reset.
Jekk taqbeż il-limitu, tirċievi HTTP 429 b'header Retry-After.

Nota: il-limitu jiġi infurzat kull server instance u jerġa' jibda mill-bidu kull restart, allura hu protezzjoni tal-użu ġust aktar milli limitu strett. Jekk teħtieġ limitu ogħla u garantit, ikkuntattjana.

Endpoints

GET/api/public/v1/parties

List all published parties.

Eżempju

curl https://elezzjonimalta.lovable.app/api/public/v1/parties

GET/api/public/v1/districts

List all 13 published electoral districts with their localities.

Eżempju

curl https://elezzjonimalta.lovable.app/api/public/v1/districts

GET/api/public/v1/candidates

List published candidates. Filter by district number/UUID or party slug/UUID.

Parametri tal-query

districtstringDistrict number 1–13 or district UUID. Filters by primary_district_id.
partystringParty slug (e.g. pn, pl, adpd) or party UUID.
limitinteger1–500 (default 100).

Eżempju

curl "https://elezzjonimalta.lovable.app/api/public/v1/candidates?district=6&party=pl"

Forma tar-risposta

L-endpoints kollha jirritornaw envelope JSON b'array data u oġġett meta li jiddeskrivi r-riżultat.

{
  "data": [ /* records */ ],
  "meta": {
    "count": 13,
    "generatedAt": "2026-04-29T08:00:00.000Z"
  }
}

Attribuzzjoni

Id-data hija miftuħa u liberament użabbli. Jekk jogħġbok ikkredita lil "Elezzjoni" b'link lura għas-sit, u ċċekkja l-paġna About għad-dettalji tas-sorsi.

Dwarna