Lewati ke konten utama

Regional Data

Dalam berbagai form registrasi (misalnya form profil akun bisnis atau informasi penagihan), Customer diwajibkan untuk memilih lokasi mereka secara hierarkis.

Gunakan endpoint publik di bawah ini untuk mengisi Dropdown / Spinner Anda di sisi Mobile.

1. Daftar Negara​

Digunakan untuk opsi kewarganegaraan atau negara domisili. Terkadang sistem Frog Cloud hanya mengunci (lock) layanan ke negara tertentu, sehingga pastikan aplikasi selalu menarik list dari API ini.

Request
GET /api/lookup/country

Respons (200 OK):

{
  "data": [
    {
      "id": 1,
      "code": "ID",
      "name": "Indonesia"
    }
  ]
}

2. Daftar Provinsi​

Secara bawaan, API ini akan mengambil daftar provinsi yang didukung.

Request
GET /api/lookup/province

Respons (200 OK):

{
  "data": [
    {
      "id": 11,
      "name": "ACEH"
    },
    {
      "id": 12,
      "name": "SUMATERA UTARA"
    }
  ]
}

3. Daftar Kota / Kabupaten​

Menarik daftar kota atau kabupaten yang secara hierarki berada di bawah Provinsi spesifik. Oleh karena itu, query parameter province_id wajib disematkan.

Request
GET /api/lookup/city?province_id=11

(Ganti 11 dengan ID Provinsi yang dipilih user sebelumnya).

Respons (200 OK):

{
  "data": [
    {
      "id": 1101,
      "province_id": 11,
      "name": "KABUPATEN SIMEULUE"
    }
  ]
}

4. Daftar Kecamatan (Districts)​

Menarik daftar kecamatan yang secara hierarki berada di bawah Kota/Kabupaten spesifik. Sama halnya, query parameter city_id wajib diberikan.

Request
GET /api/lookup/district?city_id=1101

Respons (200 OK):

{
  "data": [
    {
      "id": 1101010,
      "city_id": 1101,
      "name": "TEUPAH SELATAN"
    }
  ]
}

Saran Implementasi UI/UX (Cascading Dropdowns)​

Untuk mencegah error pada saat memanggil data kota dan kecamatan, buat logic UI Anda bekerja secara Cascading (Berantai):

  1. Dropdown Kota berada dalam status Disabled sebelum pengguna berhasil memilih Provinsi.
  2. Dropdown Kecamatan berada dalam status Disabled sebelum pengguna berhasil memilih Kota.
  3. Jika pengguna merubah kembali Provinsi-nya, pastikan Anda otomatis melakukan Reset (kosongkan nilai) pada opsi Kota dan Kecamatan.