# Report API

> Kirim laporan data salah, bug, atau saran fitur langsung lewat API.

Endpoint bagi pengguna untuk melaporkan data yang keliru atau tidak cocok, bug, kekurangan dokumentasi, penyalahgunaan, maupun saran fitur, langsung dari aplikasi tanpa formulir terpisah. Kategori laporan yang didukung: data_salah, bug, dokumentasi, penyalahgunaan, saran_fitur, dan lainnya. Setiap laporan mendapat ID yang bisa dipakai untuk mengecek status penanganannya.

- Base URL: `https://api.apipedia.id/v1/report`
- Autentikasi: `Authorization: Bearer apk_…` (token dari console.apipedia.id)
- Kategori: Data Publik
- Halaman: https://apipedia.id/docs/report-api
- OpenAPI: https://console.apipedia.id/openapi/report-api.yaml

Semua respons memakai amplop `{ "is_success", "message", "data" }` kecuali disebutkan lain. Kode error umum: lihat https://apipedia.id/docs#kode-status-error.

## Endpoint (3)

- `GET /`: Daftar laporan milik akun ini
- `POST /`: Kirim laporan masalah atau masukan ke tim APIPedia
- `GET /{id}`: Cek status satu laporan

### Daftar laporan milik akun ini

`GET https://api.apipedia.id/v1/report`

Maksimal 50 laporan terbaru yang dikirim lewat Report API, terbaru lebih dulu.

Contoh request:

```bash
curl -X GET "https://api.apipedia.id/v1/report" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx"
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "Daftar laporan berhasil diambil",
  "data": {
    "items": [
      {
        "id": "6f1c2a9e-3b7d-4e21-9a0c-5d8e7f4b2a10",
        "ticket_number": "202610290007",
        "category": "bug",
        "subject": "Respons /qr/generate lambat",
        "status": "ditinjau",
        "created_at": "2026-10-29T04:20:00Z",
        "updated_at": "2026-10-29T06:05:00Z",
        "resolved_at": null,
        "console_url": "https://console.apipedia.id/tickets"
      }
    ],
    "total": 1
  }
}
```

### Kirim laporan masalah atau masukan ke tim APIPedia

`POST https://api.apipedia.id/v1/report`

Kategori yang didukung: data_salah, bug, dokumentasi, penyalahgunaan, saran_fitur, dan lainnya (bawaan). Hanya `description` (minimal 10 karakter) yang wajib; `subject` diambil dari awal deskripsi kalau kosong. Field `endpoint` dan `request_id` opsional, isi kalau laporan terkait satu pemanggilan API tertentu supaya tim bisa menelusuri lebih cepat. Laporan disimpan sebagai tiket dan langsung muncul di menu Tiket konsol; balasan tim juga bisa dibaca di sana. Laporan penyalahgunaan otomatis berprioritas tinggi.

Body (`application/json`, wajib):

```json
{
  "category": "bug",
  "subject": "Respons /qr/generate lambat",
  "description": "Endpoint QR butuh lebih dari 10 detik sejak pagi ini.",
  "endpoint": "/qr/generate",
  "request_id": "req_8a12f0"
}
```

Contoh request:

```bash
curl -X POST "https://api.apipedia.id/v1/report" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"category":"bug","subject":"Respons /qr/generate lambat","description":"Endpoint QR butuh lebih dari 10 detik sejak pagi ini.","endpoint":"/qr/generate","request_id":"req_8a12f0"}'
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "Laporan berhasil dikirim. Pantau statusnya di menu Tiket konsol.",
  "data": {
    "id": "6f1c2a9e-3b7d-4e21-9a0c-5d8e7f4b2a10",
    "ticket_number": "202610290007",
    "category": "bug",
    "subject": "Respons /qr/generate lambat",
    "status": "diterima",
    "created_at": "2026-10-29T04:20:00Z",
    "updated_at": "2026-10-29T04:20:00Z",
    "resolved_at": null,
    "console_url": "https://console.apipedia.id/tickets"
  }
}
```

### Cek status satu laporan

`GET https://api.apipedia.id/v1/report/{id}`

`id` boleh berupa id laporan (uuid) atau nomor tiket 12 digit yang tampil di konsol. Status: diterima, ditinjau, menunggu_balasan, selesai, ditutup. `last_reply` berisi balasan terakhir dari tim, atau null kalau belum ada.

| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| `id` | path | string | ya | - |

Contoh request:

```bash
curl -X GET "https://api.apipedia.id/v1/report/202610290007" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx"
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "Status laporan berhasil diambil",
  "data": {
    "id": "6f1c2a9e-3b7d-4e21-9a0c-5d8e7f4b2a10",
    "ticket_number": "202610290007",
    "category": "bug",
    "subject": "Respons /qr/generate lambat",
    "status": "menunggu_balasan",
    "created_at": "2026-10-29T04:20:00Z",
    "updated_at": "2026-10-29T06:05:00Z",
    "resolved_at": null,
    "last_reply": {
      "message": "Terima kasih, sudah kami perbaiki. Bisa dicoba lagi?",
      "created_at": "2026-10-29T06:05:00Z"
    },
    "console_url": "https://console.apipedia.id/tickets"
  }
}
```
