Distributor API Documentation

Gunakan Bearer Token pada setiap request untuk autentikasi.

🔑 Demo Access Token

Gunakan token ini untuk mencoba API:

demotoken98765

⚠️ Disclaimer: Token ini adalah token demo, hanya dapat menampilkan maksimal 10 data distributor dan hanya untuk keperluan testing publik. Untuk akses penuh, silakan upgrade ke paket berbayar.

🏅 Membership Levels

Level Deskripsi
Silver Akses sangat terbatas, hanya bisa melihat sebagian kecil distributor. Cocok untuk pengguna baru yang sekadar ingin mencoba.
Gold Akses lebih banyak, bisa melihat distributor aktif di seluruh kota. Direkomendasikan untuk pengguna yang serius mencari partner.
Diamond Akses penuh ke semua data distributor tanpa batasan, termasuk fitur premium lainnya. Khusus untuk member berbayar premium.

GET /api/distributors

Mengambil daftar distributor berdasarkan level member (level otomatis dibaca dari token).

Parameters

Nama Tipe Deskripsi
- - Tidak ada parameter. Level member ditentukan otomatis dari token.

Coba Sekarang


POST /api/distributors/nearest

Mendapatkan distributor terdekat berdasarkan koordinat (latitude, longitude) dan kota.

Request Body

{
    "latitude": ,  // Latitude pengguna
    "longitude": , // Longitude pengguna
    "kota": "" // Nama kota yang akan digunakan untuk filter
}

Headers

Header Deskripsi
Authorization Bearer Token untuk autentikasi. Token ini digunakan untuk menentukan akses level pengguna (demo, gold, exclusive).

Request Sample (copy ini)

Token Latitude Longitude Kota
demotoken98765 -6.9283041 107.6902451 Bandung

Coba Sekarang



Response

Response akan mengembalikan daftar distributor terdekat dalam format JSON, dengan informasi seperti nama distributor, alamat, dan jarak (dalam kilometer).

Contoh Response (Success)

[
    {
        "id": 11,
    "badan_hukum": "6",
    "nama": "Bangun Jaya TB",
    "alamat": "KOTA BANDUNG",
    "alamat_lengkap": "Jl. Ahmad Yani No. 706",
    "alamat_kelurahan": "CICAHEUM",
    "alamat_kecamatan": "KIARACONDONG",
    "alamat_provinsi": "JAWA BARAT",
    "kode_pos": "40282",
    "alamat_latt": "-6.9044158",
    "alamat_long": "107.6561438",
    "no_telepon": "0227274880",
    "email": "-",
    "website": "Tidak Diketahui",
    "status": "aktif",
    "logo": "default-logo.png",
    "validator": null,
    "created_at": "2025-04-30 23:37:59",
    "updated_at": "2025-04-30 23:37:59",
    "deleted_at": null,
    "validator_date": null,
    "created_by": 2,
    "updated_by": null,
    "deleted_by": null,
    "distance": 4.607129709380339
    }
]

Contoh Response (Error)

{
    "error": "No distributors found within the specified range."
}

Response Status Codes

Status Code Deskripsi
200 OK Data distributor terdekat berhasil diambil.
400 Bad Request Request tidak valid, misalnya parameter yang tidak lengkap.
401 Unauthorized Token yang digunakan tidak valid atau tidak ada akses yang cukup.
500 Internal Server Error Terjadi kesalahan di server saat memproses permintaan.

GET /api/distributors/{id}

Mengambil detail satu distributor berdasarkan ID.

Path Parameter

Nama Tipe Deskripsi
id integer ID distributor yang ingin diambil detailnya.

Headers

Header Deskripsi
Authorization Bearer Token untuk autentikasi.

Coba Sekarang



Contoh Response

{
  "id": 2,
  "badan_hukum": "Perusahaan Daerah(PD)",
  "nama": "Toko Kayu Cahaya Rimba Masa",
  "alamat": "KOTA BANDUNG",
  "alamat_lengkap": "Jl. Soekarno Hatta (Sebelah Hotel Shakti)",
  "alamat_kelurahan": "CIMINCRANG",
  "alamat_kecamatan": "GEDEBAGE",
  "alamat_provinsi": "JAWA BARAT",
  "kode_pos": "40294",
  "alamat_latt": "-6.9528577",
  "alamat_long": "107.6981185",
  "no_telepon": "08978",
  "email": "siti@gmail.com",
  "website": "tidakdiketahui",
  "status": "aktif",
  "logo": "logos/hOMxIXU77WxAKC0aOwGISNQD3bSAR9VrHTrRSuCI.jpg",
  "validator": null,
  "created_at": "2025-04-30T00:32:09.000000Z",
  "updated_at": "2025-04-30T08:18:34.000000Z",
  "deleted_at": null,
  "validator_date": null,
  "created_by": 2,
  "updated_by": 1,
  "deleted_by": null,
  "badanhukum": {
    "id": 6,
    "nama": "Perusahaan Daerah(PD)",
    "created_at": "2025-05-04T21:56:21.000000Z",
    "updated_at": "2025-05-04T21:56:21.000000Z",
    "deleted_at": null,
    "created_by": null,
    "updated_by": null,
    "deleted_by": null
  }
}

Response Status Codes

Status Code Deskripsi
200 OK Data distributor berhasil diambil.
404 Not Found Distributor dengan ID tersebut tidak ditemukan.
401 Unauthorized Token tidak valid atau tidak ada.
Kembali ke Home