v1

latestOpenAPI 3.0.02026-07-26318168886.7 KB
Promotions

Get Customer Coupon Promotions

To get customer coupon promotions with promotion_ids.<br> The API returns promotions only if the given promotions whose type are draw.<br> And it returns the promotions which are available to draw or have already been drawn.<br> It returns null if the given promotions are not available.<br><br> 使用 promotion_ids 獲取用戶優惠活動。<br> 此 API 只會回傳傳入的 promotion_ids 中,類型為領取型的優惠活動,並僅回傳已領取或可領取的優惠動。<br> 若傳入的 promotion_ids 中有不可領取的優惠活動,則該優惠活動會回傳 null。

get/customers/{customer_id}/coupon_promotions

Path parameters

customer_idstring required

用戶id

Query parameters

promotion_idsstring[] required

優惠活動 ID

Response

OK

Example response

{
  "5e8445bcca53240021eab706": null,
  "5e8445bcca53240021eab707": {
    "id": "5e8445bcca53240021eab706",
    "title_translations": {
      "en": "string",
      "zh-hant": "string",
      "zh-cn": "string",
      "vi": "string",
      "ms": "string",
      "ja": "string",
      "th": "string",
      "id": "string",
      "de": "string",
      "fr": "string"
    },
    "discount_on": "order",
    "first_purchase_only": true,
    "first_purchase_all_platform": true,
    "codes": [
      "VIP001",
      "VIP002"
    ],
    "user_max_use_count": 1,
    "max_use_count": 20,
    "use_count": 5,
    "user_use_count": 5,
    "start_at": "2020-07-09T04:00:00.000+00:00",
    "end_at": "null",
    "available_platforms": [
      "string"
    ],
    "coupon_type": "draw",
    "drew_coupon_count": 20,
    "user_coupon_status": "active"
  }
}