API v1

REST API

Akses programatik te dëshmitë e verifikuara dhe statistikat publike.

Autentifikimi

Çdo kërkesë kërkon header-in X-API-Key. Çelësi demo:

X-API-Key: dsh_demo_key_2026

GET /api/v1/reports

Lista e raporteve të verifikuara. Filtra opsionalë: category, city, status, since (ISO date).

curl "https://mozaiku.al/api/v1/reports?category=corruption&city=Tiran%C3%AB&status=verified" \
  -H "X-API-Key: dsh_demo_key_2026"

Përgjigja

{
  "data": [
    {
      "code": "DSH-432187",
      "category": "corruption",
      "description": "...",
      "city": "Tiranë",
      "status": "verified",
      "support_count": 142,
      "created_at": "2026-06-09T10:21:00Z"
    }
  ],
  "count": 24
}

GET /api/v1/stats

Statistika publike agregate.

curl "https://mozaiku.al/api/v1/stats" -H "X-API-Key: dsh_demo_key_2026"

{
  "total_reports": 387,
  "by_category": { "corruption": 174, "environment": 88, ... },
  "by_city": { "Tiranë": 142, "Durrës": 56, ... }
}

Limitet (rate limits)

Tier	Kërkesa / minutë	Çmimi
Demo	10	Falas
Pro	120	€79/muaj
API	1000	€199/muaj

Kodet e gabimit

401 — Çelësi mungon ose është i pavlefshëm
429 — Tepruar kufiri i kërkesave
500 — Gabim serveri

Dëshironi akses produksioni? Shikoni planet ose shkruani te partnere@mozaiku.al.