Cửa hàng — Cập nhật & cấu hình Webhook
Cập nhật thông tin cửa hàng và bật/cấu hình webhook.
Cập nhật cấu hình cửa hàng, bao gồm bật webhook, URL nhận, loại sự kiện và header tuỳ chỉnh.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
PUT | /api/v1/shops/{shop_id} | Cập nhật cửa hàng / webhook |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
shop_id | đường dẫn | string | Có | ID cửa hàng |
webhook_enable | thân | boolean | Không | Bật/tắt webhook |
webhook_url | thân | string | Không | URL nhận webhook (HTTPS) |
webhook_types | thân | string[] | Không | Loại sự kiện: orders, customers, products, variations_warehouses, auto_call |
webhook_headers | thân | object | Không | Header tuỳ chỉnh gửi kèm |
Kiểm thử tại chỗ
PUT
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}Kiểm thử tại chỗNhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.
Tham số đường dẫn
Body
cURL mẫu (PUT)
curl -X PUT "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"shop": {
"webhook_enable": true,
"webhook_url": "https://ban.example.com/hook",
"webhook_types": [
"orders",
"variations_warehouses"
]
}
}'Phản hồi mẫu
{
"status": "success",
"data": {
"id": "shop_0a1b2c3d",
"webhook_enable": true,
"webhook_url": "https://ban.example.com/hook",
"webhook_types": [
"orders",
"variations_warehouses"
]
}
}Mỗi loại sự kiện trong
webhook_types tương ứng một payload riêng. Xem trang Webhook — Danh sách sự kiện.Cập nhật cấu hình cửa hàng, bao gồm bật webhook, URL nhận, loại sự kiện và header tuỳ chỉnh.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
PUT | /api/v1/shops/{shop_id} | Cập nhật cửa hàng / webhook |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
shop_id | đường dẫn | string | Có | ID cửa hàng |
webhook_enable | thân | boolean | Không | Bật/tắt webhook |
webhook_url | thân | string | Không | URL nhận webhook (HTTPS) |
webhook_types | thân | string[] | Không | Loại sự kiện: orders, customers, products, variations_warehouses, auto_call |
webhook_headers | thân | object | Không | Header tuỳ chỉnh gửi kèm |
Kiểm thử tại chỗ
PUT
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}Kiểm thử tại chỗNhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.
Tham số đường dẫn
Body
Mỗi loại sự kiện trong
webhook_types tương ứng một payload riêng. Xem trang Webhook — Danh sách sự kiện.cURL mẫu (PUT)
curl -X PUT "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"shop": {
"webhook_enable": true,
"webhook_url": "https://ban.example.com/hook",
"webhook_types": [
"orders",
"variations_warehouses"
]
}
}'Phản hồi mẫu
{
"status": "success",
"data": {
"id": "shop_0a1b2c3d",
"webhook_enable": true,
"webhook_url": "https://ban.example.com/hook",
"webhook_types": [
"orders",
"variations_warehouses"
]
}
}