# API Overview — Zammad REST

> **Terakhir Diperbarui:** 2026-07-02
> Dokumentasi resmi: https://docs.zammad.org/en/latest/api/intro.html

---

## Base URL (target produksi)

```
https://zammad.gisportal.id/api/v1/
```

---

## Autentikasi

| Metode | Header | Use case |
|--------|--------|----------|
| **Token** | `Authorization: Token token=<api_token>` | FE backend / integrasi |
| **Basic** | `Authorization: Basic ...` | Testing, admin tools |
| **OAuth** | *(opsional)* | Belum direncanakan |

Token dibuat di Zammad: **Profile → Token Access** atau admin untuk service account.

---

## Endpoint yang relevan untuk FE `/ticketing`

| Method | Path | Keterangan |
|--------|------|------------|
| GET | `/tickets` | Daftar tiket user |
| POST | `/tickets` | Buat tiket baru |
| GET | `/tickets/{id}` | Detail tiket |
| POST | `/ticket_articles` | Balasan / komentar |
| GET | `/users/me` | User saat ini |
| GET | `/groups` | Group untuk routing |

> Schema lengkap mengikuti versi Zammad yang diinstall — verifikasi setelah deploy.

---

## Response format

JSON. Error umum: `401` (token invalid), `422` (validasi), `500` (server).

---

## Rate limiting

Belum dikonfigurasi — rencana rate limit di nginx setelah go-live.