Pencarian (Search)

Dokumentasi API untuk fitur pencarian produk, saran kata kunci (suggestions), serta pengelolaan riwayat pencarian pengguna.

Endpoint Overview

Method	Endpoint	Deskripsi
GET	`/themes`	Mengambil kata kunci populer dan riwayat pencarian terakhir.
GET	`/products/suggestion`	Mengambil saran produk/kata kunci saat pengguna mengetik.
DELETE	`/search-keys/:key`	Menghapus satu kata kunci dari riwayat pencarian pengguna.
DELETE	`/search-keys`	Menghapus seluruh riwayat pencarian pengguna.

1. Get Search Metadata

Metadata pencarian dikirimkan sebagai bagian dari konfigurasi Home Page untuk menampilkan saran pencarian populer.

URL: /themes?home_page=true
Method: GET
Headers: Authorization: Bearer {{token}} (Opsional)
Response Snippet:

{
  "home_page": {
    "search": {
      "popular_search": ["bali", "desa wisata", "bromo"],
      "last_user_search": ["jogja", "pantai parangtritis"]
    }
  }
}

2. Search Suggestions

Memberikan saran produk atau kategori berdasarkan input teks yang dimasukkan pengguna secara real-time.

URL: /products/suggestion
Method: GET
Query Parameters:
- q (string, required): Kata kunci pencarian.
- type: experience, destination, atau village.
Response (200 OK):

{
  "products": [
    { "product_name": "Paket Wisata Bali", "slug": "paket-wisata-bali" }
  ],
  "popular_key": ["bali", "pantai"]
}

3. Delete Search History

Manajemen riwayat pencarian untuk privasi pengguna. Membutuhkan autentikasi untuk menghapus data dari akun user.

URL: /search-keys/:key (Spesifik) atau /search-keys (Semua)
Method: DELETE
Headers: Authorization: Bearer {{token}}
Response (200 OK):

{
  "message": "Search history deleted successfully"
}

🔥 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.