Data Master (Global)

Dokumentasi ini mencakup seluruh data referensi global yang digunakan secara konsisten di seluruh platform Atourin, mulai dari data wilayah hingga kategori produk.

📑 Wilayah (Region)

Sistem menggunakan data wilayah Indonesia yang tersinkronisasi untuk mempermudah filter pencarian:

Provinsi: Daftar seluruh provinsi di Indonesia.
Kota/Kabupaten: Daftar kota yang terkait dengan masing-masing provinsi.

Endpoint Wilayah

GET /regions : Mengambil daftar seluruh provinsi.
GET /regions/:province_id/cities : Mengambil daftar kota berdasarkan ID provinsi.

📑 Kategori Produk

Daftar kategori global yang digunakan untuk mengklasifikasikan produk:

Eksplorasi (Experience): Budaya, Alam, Sejarah, Kuliner.
Atraksi (Attraction): Museum, Taman Hiburan, Galeri Seni.
Lainnya: Event, Kerajinan Tangan, dsb.

Endpoint Kategori

GET /master/categories : Mengambil daftar kategori produk yang aktif.

📑 Data Pendukung Lainnya

Sistem juga menyediakan data master untuk:

Languages: Daftar bahasa yang tersedia untuk pemanduan tur.
Trip Types: Daftar jenis perjalanan (Solo, Keluarga, dll).
Currencies: Informasi mata uang (Internal reference).

🛠️ Format Data Penting

Contoh Struktur Wilayah

{
  "id": "uuid-bali",
  "name": "Bali",
  "cities": [
    { "id": "uuid-badung", "name": "Badung" },
    { "id": "uuid-denpasar", "name": "Denpasar" }
  ]
}

🚀 Best Practices

Caching: Data master bersifat jarang berubah. Sangat disarankan untuk melakukan caching di sisi klien (local storage atau state management) untuk mengurangi beban API.
Standardisasi ID: Selalu gunakan UUID yang dikembalikan dari API ini untuk melakukan filter pada endpoint produk/homestay.

Update Terakhir: 20 Maret 2026