Ulasan (Reviews)

Dokumentasi API untuk sistem umpan balik pengguna, rating produk per kategori, dan jenis perjalanan.

Endpoint Overview

Method	Endpoint	Deskripsi
GET	`/reviews`	Mengambil daftar ulasan dengan pagination & filter.
GET	`/reviews/:id`	Mengambil detail ulasan & rating per kategori.
GET	`/reviews/categories`	Ambil kategori penilaian (Lokasi, Layanan, dll).
POST	`/reviews`	Mengirim ulasan baru (mendukung Foto/Video).
POST	`/reviews/:id/helpful`	Menandai ulasan sebagai bermanfaat bagi orang lain.

1. List Reviews

Mendapatkan feedback pengguna untuk produk, partner, atau user tertentu.

URL: /reviews
Method: GET
Query Parameters:
- product: Slug produk (Filter per produk).
- partner: Slug partner (Filter per mitra).
- sort: latest, oldest, high_rate, low_rate.
- filter: all, media (Jika hanya ingin review dengan foto/video).
Response (200 OK):

{
  "row": [
    {
      "id": "uuid-01",
      "rating": 4.5,
      "message": "Sangat memuaskan!",
      "media": {
        "image": ["https://..."],
        "video": []
      },
      "helpful_count": 12
    }
  ]
}

2. Submit Review

Mengirim kontribusi ulasan setelah transaksi selesai. Menggunakan format multipart/form-data untuk mendukung unggahan media.

URL: /reviews
Method: POST
Body (Form-Data):
- trans_id: ID Transaksi.
- message: Teks ulasan.
- ratings: JSON string kategori rating (Contoh: [{"category_id":"uuid","rating":5}]).
- files: File foto/video (Opsional).

3. Helpfulness Toggle

Memberikan apresiasi pada ulasan yang dianggap informatif.

URL: /reviews/:id/helpful
Method: POST
Body: { "is_helpful": true }
Response (200 OK): Mengembalikan helpful_count terbaru.

🔥 Uji Coba API (Simulator)

Gunakan simulator di bawah ini untuk mencoba seluruh endpoint di atas secara langsung. Anda dapat mengubah URL, Method, Headers, dan Body sesuai kebutuhan.