# Report API

Report API APIPedia: Kirim laporan data salah, bug, atau saran fitur langsung lewat API. Panggil dengan satu token API di `https://api.apipedia.id/v1/report`.

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": "Report list retrieved",
  "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": "Report submitted. Track its status in the Tickets menu of the console.",
  "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": "Report status retrieved",
  "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"
  }
}
```
