Skip to content

Get Product Tickets Usage Records

Description

取得商品券使用紀錄。

Resource

GET /v1/ticket/product/usage_records

Authorization

採用 OAuth 2.0 Bearer Token,詳細使用流程請參考 Auth Login

Query Parameters

Name Type Description
sale_kind List[string]
(enum)
銷售類型
ALLOWED VALUES:
  • GENERAL
  • PICKUP
  • POINT
GENERAL=一般
PICKUP=跨店隨取
POINT=點數兌換商品
(optional)
Example : [GENERAL,PICKUP]
order_id string 訂單編號
(optional)
start_date string 開始日期 (例:2020-08-14 12:00:00)
(optional)
end_date string 結束日期 (例:2020-08-14 23:59:59)
(optional)

Request

GET /v1/ticket/product/usage_records?sale_kind=[GENERAL,PICKUP]&order_id=STORE2005010001&start_date=2020-08-14 12:00:00&end_date=2020-08-14 23:59:59

Response Body Parameters

Name Type Description
product_name string 商品名稱
image_url string 圖檔URL
redeem_date string 兌換日期
EXAMPLE 2022-04-20
redeem_store_name string 兌換門市名稱
redeem_quantity int 兌換數量

Response

{
  "tickets": [
    {
      "product_name": "美式咖啡",
      "image_url": "http://40.83.96.208:8080/kiosk/app/public/product00/5839-1-1550816490_s.png",
      "redeem_date": "2020-01-01",
      "redeem_store_name": "門市簡稱",
      "redeem_quantity": 5
    },
    {
      "product_name": "美式咖啡",
      "image_url": "http://40.83.96.208:8080/kiosk/app/public/product00/5839-1-1550816490_s.png",
      "redeem_date": "2020-01-01",
      "redeem_store_name": "門市簡稱",
      "redeem_quantity": 5
    }
  ]
}