REST API
Pintu gerbang REST untuk sistem luaran ASWARA. Semua titik akhir awam membaca kandungan yang telah diterbitkan sahaja; operasi tulis memerlukan token kakitangan dan mematuhi kawalan RBAC yang sama seperti panel pentadbiran. GraphQL tersedia di /api/graphql.
| Kaedah | Laluan | Keterangan |
|---|---|---|
| GET | /api/exhibitions ?locale=en&depth=1&limit=10 | Senarai pameran diterbitkan (where[workflowStatus][equals]=diterbitkan automatik untuk awam) |
| GET | /api/exhibitions/:id ?locale=ms&depth=2 | Satu pameran dengan karya, babak 360 dan kuiz |
| GET | /api/artworks ?where[category][equals]=tari&sort=-year | Katalog karya — tapis ikut kategori, seniman, tahun |
| GET | /api/artworks/:id | Satu rekod karya (dokumen dalaman disembunyikan untuk awam) |
| GET | /api/artists ?locale=en | Profil seniman yang mempunyai persetujuan PDPA |
| GET | /api/quizzes/:id | Soalan kuiz apresiasi |
| GET | /api/media/file/:filename | Fail media (imej, audio, video) |
| POST | /api/users/login | Log masuk kakitangan → token JWT (Authorization: JWT <token>) |
Spesifikasi penuh OpenAPI/Swagger dan kunci API (OAuth2 client credentials) disediakan pada fasa integrasi.