Coupon List

Function

券列表

Endpoint

/v1/coupon/list

HTTP Method

POST

Request Body

get coupon list from general content

{
  "channel":"app_gc"
}

get coupon list from app rewards

{
  "channel":"app_rewards"
}

Request Parameters

Field	Required	Type	Remark	Sample
channel	Yes	string	渠道: app_gc、app_rewards	app_rewards

Response Body - Success

{
    "code": 0,
    "msg": "success",
    "data": {
      "list": [
        {
          "coupon_id": "DP003149",
          "mall_id": "DP01",
          "name_sc": "D·PARK 平日免费泊车电子优惠券(P1)",
          "name_tc": "D·PARK 平日免費泊車電子優惠券(P1)",
          "name_en": "D·PARK Weekday Free Parking Coupon(P1)",
          "description_en":"",
          "description_sc":"",
          "description_tc":"",
          "rules_sc": "< a href=\"www.dpark.com.hk/STparking\">www.dpark.com.hk/STparking</ a>\r\n1) 此優惠券有效期至2021年2月28日。\r\n2) 此優惠券只適用於星期一至五, 公眾假期除外。\r\n3) 憑此優惠券可於有效期的指定時間內於愉景新城停車場享用免費泊車。\r\n4) 泊車時間必須為上午6時至晚上9時\r\n5) 此優惠券使用人必須支付超出此泊車券價值的相關泊車費用。\r\n6) 此優惠券僅供會員已登記之車牌號碼使用。\r\n7) 當使用至編號為P8的全日任泊通行票時, 系統將自動發送另外十張全日任泊通行票至會員手機APP內，請查閣收件箱。\r\n8) 此優惠券不可兌換現金、禮券或其他禮品。\r\n9) 此優惠券只限使用一次,可與其他泊車優惠同時使用。\r\n10) 此優惠券的使用受適用的愉景新城停車場守則限制。\r\n11) 如有任何爭議, 愉景新城商業服務有限公司保留最終決定權。",
          "rules_tc": "1) 此優惠券有效期至2021年2月28日。\r\n2) 此優惠券只適用於星期一至五, 公眾假期除外。\r\n3) 憑此優惠券可於有效期的指定時間內於愉景新城停車場享用免費泊車。\r\n4) 泊車時間必須為上午6時至晚上9時\r\n5) 此優惠券使用人必須支付超出此泊車券價值的相關泊車費用。\r\n6) 此優惠券僅供會員已登記之車牌號碼使用。\r\n7) 當使用至編號為P8的全日任泊通行票時, 系統將自動發送另外十張全日任泊通行票至會員手機APP內，請查閣收件箱。\r\n8) 此優惠券不可兌換現金、禮券或其他禮品。\r\n9) 此優惠券只限使用一次,可與其他泊車優惠同時使用。\r\n10) 此優惠券的使用受適用的愉景新城停車場守則限制。\r\n11) 如有任何爭議, 愉景新城商業服務有限公司保留最終決定權。",
          "rules_en": "1) This coupon is valid till Feb 28, 2021.\r\n2) This coupon is applicable for Monday to Friday (Public Holidays are excluded).\r\n3) This coupon entitles the holder to enjoy complimentary parking in specific time slot at the D·PARK Carpark on or before the expiry date of this coupon.\r\n4) Parking timeslot is 6am to 9pm.\r\n5) Applicable parking charges which exceed the value of this coupon shall be paid by the user of this coupon.\r\n6) This coupon is applicable to registered license plate only.\r\n7) Another 10 parking digital coupons will be sent to app automatically when the coupon marked with P8 is used, please check inbox.\r\n8) This coupon cannot be exchanged for cash, other coupons or items.\r\n9) This coupon can be used once only, it can be used conjunction with other coupons.\r\n10) Use of this coupon shall be subject to the applicable regulations of the D·PARK Carpark.\r\n11) If any disputes, Discovery Park Commercial Services Limited reserves the right for final decision.", 
          "logo_url": "http://dpclub.dpark.com.hk/site/uat/photo/DP01DP003149_1.jpg",
          "quantity": 2,
          "effective_date":"2021-01-07",
          "expiry_date":"2021-02-28",
          "use_effective_type":"1",
          "use_effective_time":"2021-01-01T00:00:00+08:00",
          "use_expiry_time":"2023-02-28T23:59:59+08:00",
          "use_expiry_days":"",
          "point": 0
        }
      ]
  }
}

Response Parameters

Field	Type	Remark	Sample
coupon_id	string	優惠券ID	DP003149
mall_id	string	Mall ID	DP01
name_sc	string	名稱-中文简体
name_tc	string	名稱-中文繁体
name_en	string	名稱-英文
description_en	string	描述-英文
description_sc	string	描述-中文简体
description_tc	string	描述-中文繁体
rules_en	string	規則-英文
rules_sc	string	規則-中文简体
rules_tc	string	規則-中文繁体
logo_url	string	圖片
quantity	string	剩餘庫存
effective_date	string	生效日期
expiry_date	string	失效日期
use_effective_type	string	用券的有效期類型, 1= 固定時間(Fix Time) , 2 = 當日有效(Today Only)， 3 = 有效天數(Effective Days)
use_effective_time	string	用券的生效時間， use_effective_type= 1
use_expiry_time	string	用券的失效時間， use_effective_type= 1
use_expiry_days	string	用券的有效天數， use_effective_type= 3
point	string	積分值	0

Diff FZ API

FZ API: GetGiftList

FZ API: GetGiftList 混合了Gift和Coupon 两种数据， New API:GetCouponList 调整为只出现coupon数据

FZ	New	Remark
GiftList.Gift.MALL_ID	mall_id
GiftList.Gift.ITEM_NO	coupon_id
GiftList.Gift.SC_NAME	name_sc
GiftList.Gift.TC_NAME	name_tc
GiftList.Gift.EN_NAME	name_en
GiftList.Gift.SC_DESCRIPTION	description_sc
GiftList.Gift.TC_DESCRIPTION	description_tc
GiftList.Gift.EN_DESCRIPTION	description_en
GiftList.Gift.GIFT_RULES_SC	rules_sc
GiftList.Gift.GIFT_RULES_TC	rules_tc
GiftList.Gift.GIFT_RULES_EN	rules_en
GiftList.Gift.SEQUENCE_NO	/
GiftList.Gift.GIFT_GROUP_CODE	/
GiftList.Gift.GIFT_GROUP_NAME_SC	/
GiftList.Gift.GIFT_GROUP_NAME_TC	/
GiftList.Gift.GIFT_GROUP_NAME_EN	/
GiftList.Gift.GIFT_TYPE	/
GiftList.Gift.EFFECTIVE_DATE	effective_date
GiftList.Gift.EXPIRY_DATE	expiry_date
GiftList.Gift.ECOUPONS_EFFECTIVE_TYPE	use_effective_type
GiftList.Gift.ECOUPONS_EFFECTIVE_TIME	use_effective_time
GiftList.Gift.ECOUPONS_EXPIRY_TIME	use_expiry_time
GiftList.Gift.ECOUPONS_EFFECTIVE_DAYS	use_expiry_days
GiftList.Gift.REMARK1	/
GiftList.Gift.REMARK2	/
GiftList.Gift.ECOUPONS_QRCODE_REMARK_SC	/
GiftList.Gift.ECOUPONS_QRCODE_REMARK_TC	/
GiftList.Gift.ECOUPONS_QRCODE_REMARK_EN	/
GiftList.Gift.GIFT_STARS_NEED	/
GiftList.Gift.ALLOW_APP_REDEMPTION	/
GiftList.Gift.ALLOW_O2O_EXCHANGE	/
GiftList.Gift.SC_PROMPT_MESSAGE	/
GiftList.Gift.TC_PROMPT_MESSAGE	/
GiftList.Gift.EN_PROMPT_MESSAGE	/
GiftList.Gift.PHOTOPATH	logo_url
GiftList.Gift.ICON	/
GiftList.Gift.GRAY_ICON	/
GiftList.Gift.RAW_IMAGE	/
GiftList.Gift.QOH	quantity
GiftList.Gift.REDEEM_QTY_LIMIT	/
GiftList.Gift.ALLOW_MULTI_QTY	/
GiftList.Gift.INPUTSTORECODE	/
GiftList.Gift.REDEMPTION_ADDR	/
GiftList.Gift.LAST_UPDATE_TIME	/
GiftList.Gift.FOR_CHARACTER_UNLOCK	/
GiftList.Gift.SHOPNAME_EN	/
GiftList.Gift.SHOPNAME_SC	/
GiftList.Gift.SHOPNAME_TC	/
GiftList.Gift.SHOPADDR_EN	/
GiftList.Gift.SHOPADDR_SC	/
GiftList.Gift.SHOPADDR_TC	/
GiftList.Gift.SHOPTEL	/
GiftList.Gift.OPENING_HOURS_EN	/
GiftList.Gift.OPENING_HOURS_SC	/
GiftList.Gift.OPENING_HOURS_TC	/
GiftList.Gift.RedeemptionRuleList.RedeemptionRule.RULE_ID	/
GiftList.Gift.RedeemptionRuleList.RedeemptionRule.RULE_DESCRIPTION	/
GiftList.Gift.RedeemptionRuleList.RedeemptionRule.RULE_REMARK	/
GiftList.Gift.RedeemptionRuleList.RedeemptionRule.BONUS_POINT	point
GiftList.Gift.RedeemptionRuleList.RedeemptionRule.ADD_PRICE	/
GiftList.Gift.RedeemptionRuleList.RedeemptionRule.ALLOW_APP_REDEMPTION	/

FZ API Response Example

{
  "GiftList": {
    "Gift": [
      "MALL_ID": "DP01",
      "ITEM_NO": "DP003149",
      "SC_NAME": "D·PARK 平日免费泊车电子优惠券(P1)",
      "TC_NAME": "D·PARK 平日免費泊車電子優惠券(P1)",
      "EN_NAME": "D·PARK Weekday Free Parking Coupon(P1)",
      "SC_DESCRIPTION": "",
      "TC_DESCRIPTION": "",
      "EN_DESCRIPTION": "",
      "GIFT_RULES_SC": "< a href=\"www.dpark.com.hk/STparking\">www.dpark.com.hk/STparking</ a>\r\n1) 此優惠券有效期至2021年2月28日。\r\n2) 此優惠券只適用於星期一至五, 公眾假期除外。\r\n3) 憑此優惠券可於有效期的指定時間內於愉景新城停車場享用免費泊車。\r\n4) 泊車時間必須為上午6時至晚上9時\r\n5) 此優惠券使用人必須支付超出此泊車券價值的相關泊車費用。\r\n6) 此優惠券僅供會員已登記之車牌號碼使用。\r\n7) 當使用至編號為P8的全日任泊通行票時, 系統將自動發送另外十張全日任泊通行票至會員手機APP內，請查閣收件箱。\r\n8) 此優惠券不可兌換現金、禮券或其他禮品。\r\n9) 此優惠券只限使用一次,可與其他泊車優惠同時使用。\r\n10) 此優惠券的使用受適用的愉景新城停車場守則限制。\r\n11) 如有任何爭議, 愉景新城商業服務有限公司保留最終決定權。",
      "GIFT_RULES_TC": "1) 此優惠券有效期至2021年2月28日。\r\n2) 此優惠券只適用於星期一至五, 公眾假期除外。\r\n3) 憑此優惠券可於有效期的指定時間內於愉景新城停車場享用免費泊車。\r\n4) 泊車時間必須為上午6時至晚上9時\r\n5) 此優惠券使用人必須支付超出此泊車券價值的相關泊車費用。\r\n6) 此優惠券僅供會員已登記之車牌號碼使用。\r\n7) 當使用至編號為P8的全日任泊通行票時, 系統將自動發送另外十張全日任泊通行票至會員手機APP內，請查閣收件箱。\r\n8) 此優惠券不可兌換現金、禮券或其他禮品。\r\n9) 此優惠券只限使用一次,可與其他泊車優惠同時使用。\r\n10) 此優惠券的使用受適用的愉景新城停車場守則限制。\r\n11) 如有任何爭議, 愉景新城商業服務有限公司保留最終決定權。",
      "GIFT_RULES_EN": "1) This coupon is valid till Feb 28, 2021.\r\n2) This coupon is applicable for Monday to Friday (Public Holidays are excluded).\r\n3) This coupon entitles the holder to enjoy complimentary parking in specific time slot at the D·PARK Carpark on or before the expiry date of this coupon.\r\n4) Parking timeslot is 6am to 9pm.\r\n5) Applicable parking charges which exceed the value of this coupon shall be paid by the user of this coupon.\r\n6) This coupon is applicable to registered license plate only.\r\n7) Another 10 parking digital coupons will be sent to app automatically when the coupon marked with P8 is used, please check inbox.\r\n8) This coupon cannot be exchanged for cash, other coupons or items.\r\n9) This coupon can be used once only, it can be used conjunction with other coupons.\r\n10) Use of this coupon shall be subject to the applicable regulations of the D·PARK Carpark.\r\n11) If any disputes, Discovery Park Commercial Services Limited reserves the right for final decision.",
      "SEQUENCE_NO": "8",
      "GIFT_GROUP_CODE": "EC",
      "GIFT_GROUP_NAME_SC": "抽獎禮品",
      "GIFT_GROUP_NAME_TC": "抽獎禮品",
      "GIFT_GROUP_NAME_EN": "Draw Gift",
      "GIFT_TYPE": "04",
      "EFFECTIVE_DATE": "01/07/2021",
      "EXPIRY_DATE": "02/28/2021",
      "ECOUPONS_EFFECTIVE_TYPE": "1",
      "ECOUPONS_EFFECTIVE_TIME": "1/7/2021 12:00:00 AM",
      "ECOUPONS_EXPIRY_TIME": "2/28/2021 12:00:00 AM",
      "ECOUPONS_EFFECTIVE_DAYS": "",
      "REMARK1": "",
      "REMARK2": "",
      "ECOUPONS_QRCODE_REMARK_SC": "",
      "ECOUPONS_QRCODE_REMARK_TC": "",
      "ECOUPONS_QRCODE_REMARK_EN": "",
      "ALLOW_APP_REDEMPTION": "1",
      "SC_PROMPT_MESSAGE": "",
      "TC_PROMPT_MESSAGE": "",
      "EN_PROMPT_MESSAGE": "",
      "PHOTOPATH": "http://dpclub.dpark.com.hk/site/uat/photo/DP01DP003149_1.jpg",
      "ICON": "http://dpclub.dpark.com.hk/site/uat/",
      "GRAY_ICON": "http://dpclub.dpark.com.hk/site/uat/",
      "RAW_IMAGE": "http://dpclub.dpark.com.hk/site/uat/",
      "QOH": "2",
      "REDEEM_QTY_LIMIT": "20",
      "ALLOW_MULTI_QTY": "0",
      "LAST_UPDATE_TIME": "2/1/2021 6:09:20 PM",
      "RedeemptionRuleList": {
        "RedeemptionRule": {
          "RULE_ID": "0000",
          "RULE_DESCRIPTION": "免費兌換",
          "RULE_REMARK": "",
          "BONUS_POINT": "0",
          "ADD_PRICE": "",
          "ALLOW_APP_REDEMPTION": "1"
       }
    ]
  }
}

Coupon List

Function​

Endpoint​

HTTP Method​

Request Body​

Request Parameters​

Response Body - Success​

Response Parameters​

Diff FZ API​

FZ API: GetGiftList​

FZ API Response Example​

Function

Endpoint

HTTP Method

Request Body

Request Parameters

Response Body - Success

Response Parameters

Diff FZ API

FZ API: GetGiftList

FZ API Response Example