Dokumentasi API Akrab

Selamat datang di dokumentasi resmi API Akrab. API ini menggunakan arsitektur RESTful untuk mengintegrasikan data stok produk secara langsung ke server Anda.

Autentikasi API Key

Untuk mengakses seluruh endpoint API, Anda wajib menyertakan header x-api-key dalam setiap permintaan (*request*) Anda dengan API Key yang valid.

Cara Mendapatkan API Key:
API key hanya dapat diperoleh melalui chat admin. Silakan menghubungi admin terkait untuk mendapatkan API key resmi Anda.

Format Header API Key

x-api-key: API_KEY_ANDA_DISINI

API Produk XDA

GET /api/regulers

Deskripsi:
Mengambil informasi data stok untuk produk XDA SERVER, dikombinasikan dengan data alokasi kuota dari database produk.

Format Parameter Respons

Parameter	Tipe	Keterangan
`config`	string	Kode produk induk (contoh: `"XDA13"`, `"AL1"`)
`count`	number	Jumlah kuota/stok yang tersedia saat ini
`open`	boolean	Status ketersediaan produk (`true` = Buka, `false` = Gangguan)
`quota_allocation`	object \| string	Alokasi detail kuota per masing-masing area/regional

Contoh Respons Sukses (JSON Array)

[
  { 
    "config": "XDA13", 
    "count": 25, 
    "open": true, 
    "quota_allocation": { 
      "Area1": 13, 
      "Area2": 15, 
      "Area3": 20, 
      "Area4": 30 
    } 
  },
  { 
    "config": "AL1", 
    "count": 12, 
    "open": false, 
    "quota_allocation": { 
      "Area1": 31, 
      "Area2": 34, 
      "Area3": 45, 
      "Area4": 70 
    } 
  }
]

Respons Error

{ "error": "Gagal mengambil data stok" }

Request via cURL

Anda dapat menguji konektivitas API langsung dari terminal atau command prompt server Anda menggunakan utilitas cURL dengan menyertakan URL dasar https://juraganxl.my.id/.

cURL dengan API Key

# Mengambil data produk Reguler
curl -X GET https://juraganxl.my.id/api/regulers \
  -H "x-api-key: API_KEY_ANDA_DISINI"