Referensi API v2.0 REST

RetailOS menyediakan REST API untuk integrasi dengan sistem lain. API tersedia di tiga endpoint utama sesuai arsitektur sistem.

Arsitektur API

Endpoint API

API	Base URL	Fungsi
Cloud Hub API	https://cloud.retailos.internal/api	API kantor pusat
Store Router API	http://localhost:8081/api	API per toko
DC Edge API	http://dc-edge:8082/api	API distribution center

Format Response

Semua API menggunakan format JSON:

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 1250
  }
}

Error response:

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Parameter 'store_id' is required"
  }
}

HTTP Status Codes

Code	Keterangan
200	Success
201	Created
400	Bad Request - parameter tidak valid
401	Unauthorized - token tidak valid
403	Forbidden - tidak memiliki akses
404	Not Found
409	Conflict - data konflik (duplikat, dll)
500	Internal Server Error

Rate Limiting

API	Limit
Cloud Hub	100 requests/menit per user
Store Router	Tidak dibatasi (lokal)
DC Edge	100 requests/menit

Halaman Terkait

• Autentikasi - Cara autentikasi API
• Cloud Hub API - Endpoint Cloud Hub
• Store Router API - Endpoint Store Router
• DC Edge API - Endpoint DC Edge