Unlock Group API

Description

Unlock Group API 允許團主（Host）將已鎖定（Locked）或已關閉（Closed）的團購訂單重新開啟（Open）。

Resource

POST /v1/order/group/{group_order_id}/unlock

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。 * 注意：必須使用團主本人的 Token 才能執行此操作，系統會比對 Token 中的 vip_id 與團主訂單的 vip_id 是否一致。

Path Parameters

Name	Type	Description
group_order_id	string	團主訂單編號 (Host Order ID)

Request Body Parameters

Name	Type	Description
store	Store	門市資訊
customer	Customer	訂購人資訊 (Ocard 會員驗證身分必填)

Store

Name	Type	Description
id	string	門市代號

Customer

Name	Type	Description
id	string	會員編號 (optional)
name	string	姓名
mobile	string	手機號碼 (optional)
address	string	地址，銷售方式為外送時必填 (order.type is DELIVERY) (optional)
vip_group_id	string	vip群組代碼 (optional)

Request Example

{
    "store": {
        "id": "A01"
    },
    "customer": {
        "name": "王小明",
        "mobile": "0912345678"
  },
}

Response Body Parameters

Name	Type	Description
id	string	團購訂單編號 (該筆被解鎖的 Group ID)

Response Example

{
    "id": "2026012300001"
}

Notes

1. 權限控管：

   • 僅限團主本人操作。若 Token 解析出的 vip_id 與訂單不符，將回傳 403 錯誤。
   • 若為 Ocard 會員，需於 Request Body customer 提供手機號碼以驗證身分。

2. 狀態變更：

   • 執行成功後，weborder_group 表中的 status 將被更新為 0 (OPEN)。
   • 解鎖後，該團購訂單可再次接受 Join Group 請求。