Store API
Kelola data toko, buat, lihat, dan update toko pada platform. Store API menyediakan endpoint untuk manajemen toko pada sistem multi-tenant.
Authentication
Semua request API membutuhkan autentikasi Bearer token pada header Authorization dan X-Tenant-Id untuk identifikasi tenant:
Authorization: Bearer YOUR_API_KEY
X-Tenant-Id: YOUR_TENANT_ID
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/partner/v1/stores | List all stores |
| GET | /api/partner/v1/stores/{store} | Get store by ID |
| POST | /api/partner/v1/stores | Create store |
| PUT | /api/partner/v1/stores/{store} | Update store |
1. List All Stores
Endpoint
GET /api/partner/v1/stores
Response
Daftar seluruh toko milik tenant.
2. Get Store By ID
Endpoint
GET /api/partner/v1/stores/{store}
Path Parameters
| Name | Type | Description |
|---|---|---|
| store | integer | Store ID |
Response
Detail data toko berdasarkan ID.
3. Create Store
Endpoint
POST /api/partner/v1/stores
Request Body Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| alias | string | Yes | Nama toko unik minimal 5 karakter |
| code | string | Yes | Kode toko unik minimal 5 karakter, max 15 karakter |
| store_url | string | Conditional | URL toko, wajib jika platform shopify/lazada/tokopedia |
| sales_channel_id | integer | Yes | ID sales channel |
| stock_ratio | string | Yes | Rasio stok |
| order_sync_enabled | boolean | No | Sinkronisasi order aktif |
| multiwarehouse_enabled | boolean | No | Multi gudang aktif |
| product_validation_enabled | boolean | No | Validasi produk aktif |
| product_sync_enabled | boolean | No | Sinkronisasi produk aktif |
| stock_validation_enabled | boolean | No | Validasi stok aktif |
| stock_sync_enabled | boolean | No | Sinkronisasi stok aktif |
| fulfillment_enabled | boolean | No | Fitur fulfillment aktif |
| chat_enabled | boolean | No | Fitur chat aktif |
| order_accept | boolean | No | Order auto-accept |
| order_draft | boolean | No | Order draft aktif |
| partner_managed | boolean | No | Dikelola partner |
| partner_name | string | No | Nama partner |
| store_platform | string | Yes | Platform toko: shopee, tokopedia, lazada, tiktok, shopify, offline, website |
Response
Toko berhasil dibuat.
4. Update Store
Endpoint
PUT /api/partner/v1/stores/{store}
Path Parameters
| Name | Type | Description |
|---|---|---|
| store | integer | Store ID |
Request Body Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| alias | string | Yes | Nama toko unik minimal 5 karakter |
| code | string | No | Kode toko unik minimal 5 karakter, max 15 karakter |
| store_url | string | Conditional | URL toko, wajib jika platform shopify/lazada/tokopedia |
| stock_ratio | numeric | No | Rasio stok (0-100) |
| order_sync_enabled | boolean | No | Sinkronisasi order aktif |
| multiwarehouse_enabled | boolean | No | Multi gudang aktif |
| product_validation_enabled | boolean | No | Validasi produk aktif |
| product_sync_enabled | boolean | No | Sinkronisasi produk aktif |
| stock_validation_enabled | boolean | No | Validasi stok aktif |
| stock_sync_enabled | boolean | No | Sinkronisasi stok aktif |
| fulfillment_enabled | boolean | No | Fitur fulfillment aktif |
| chat_enabled | boolean | No | Fitur chat aktif |
| order_accept | boolean | No | Order auto-accept |
| order_draft | boolean | No | Order draft aktif |
| partner_managed | boolean | No | Dikelola partner |
| partner_name | string | No | Nama partner |
| store_platform | string | Yes | Platform toko: shopee, tokopedia, lazada, tiktok, shopify, offline, website |
| connection_status | string | No | Status koneksi: connected, disconnected, pending |
| connected_at | string | No | Waktu terkoneksi |
| disconnected_at | string | No | Waktu disconnect |
Response
Toko berhasil diupdate.
Response Format
Semua response akan dalam format standar JSON API response.