Get Ocard Member Tickets

Description

取得 Ocard 會員可用票卷列表。

Resource

GET /v1/ticket/ocard

Authorization

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

Query Parameters

Name	Type	Description
mobile	string	手機號碼

Request Example

GET /v1/ticket/ocard?mobile=0903123123

Response Body Parameters

Name	Type	Description
coupons	Coupon[]	票券列表

Response Body Parameters - Ticket

Name	Type	Description
id	string	票券編號
title	string	票券名稱
start_time	string	有效起日
end_time	string	有效迄日
image	string	圖片網址
pos_code	integer	促銷編號，對應 Cloud Wise 促銷編號

Response Example 有資料 - Http Code = 200

{
    "coupons": [
        {
            "id": "1NWLGQK3G",
            "title": "滿量促銷 (紅茶鮮奶第二杯 6 折)",
            "start_time": "2025-12-16 16:27:46",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/9c5b8ef3b34997d65a71f01b57980fad.png",
            "pos_code": "0PM202512160002"
        },
        {
            "id": "10RJ4KOM3",
            "title": "滿量促銷 (紅茶鮮奶第二杯 6 折)",
            "start_time": "2025-12-16 16:27:46",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/9c5b8ef3b34997d65a71f01b57980fad.png",
            "pos_code": "0PM202512160002"
        },
        {
            "id": "1L5LE9ZK8",
            "title": "滿量促銷 (紅茶鮮奶第二杯 6 折)",
            "start_time": "2025-12-16 16:27:46",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/9c5b8ef3b34997d65a71f01b57980fad.png",
            "pos_code": "0PM202512160002"
        },
        {
            "id": "1XML8JYNM",
            "title": "滿量促銷 (紅茶鮮奶第二杯 6 折)",
            "start_time": "2025-12-16 16:27:46",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/9c5b8ef3b34997d65a71f01b57980fad.png",
            "pos_code": "0PM202512160002"
        },
        {
            "id": "1WWL1LZJX",
            "title": "滿額促銷 (滿 $50 折 $30)",
            "start_time": "2025-12-16 10:46:41",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/e439633e394586beab5c88cad19bdbbf.png",
            "pos_code": "0PM202512160001"
        },
        {
            "id": "1YYLELN1N",
            "title": "滿額促銷 (滿 $50 折 $30)",
            "start_time": "2025-12-16 10:46:41",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/e439633e394586beab5c88cad19bdbbf.png",
            "pos_code": "0PM202512160001"
        },
        {
            "id": "14GOWOZKO",
            "title": "滿額促銷 (滿 $50 折 $30)",
            "start_time": "2025-12-16 10:46:41",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/e439633e394586beab5c88cad19bdbbf.png",
            "pos_code": "0PM202512160001"
        },
        {
            "id": "113R9R21O",
            "title": "滿額促銷 (滿 $50 折 $30)",
            "start_time": "2025-12-16 10:46:41",
            "end_time": "2035-12-14 23:59:59",
            "image": "https://d3egcl3bvwgcig.cloudfront.net/coupon/e439633e394586beab5c88cad19bdbbf.png",
            "pos_code": "0PM202512160001"
        }
    ]
}

Response Example 沒資料 - Http Code = 200

{
    "coupons": []
}