CFT-周大福
  1. 企点
CFT-周大福
在线API
  • 在线API
  • 接口鉴权说明
  • 接口说明
  • 会员场景
    • 会员绑定
      POST
    • 国家代码查询
      POST
    • 手机号修改
      POST
    • 会员修改
      POST
    • 会员卡号查询Global ID
      POST
    • 会员注册
      POST
    • 会员解绑
      POST
    • 会员查询
      POST
    • 会员扩展数据辅助表查询
      POST
    • 会员注销
      POST
    • 会员查询绑定
      POST
    • 会员查询(批量分页)
      POST
    • 会员跨境
      POST
    • 会员沟通渠道
      POST
  • 等级场景
    • 查询等级配置列表
      POST
    • 等级查询
      POST
    • 明细查询
      POST
  • mdm场景
    • 组织结构同步
      POST
    • 商品同步
      POST
    • 门店列表
      POST
    • 门店同步
      POST
  • 积分场景
    • 积分膨胀
      • 门店是否满足积分膨胀活动
      • 积分膨胀
      • 积分膨胀-取消
      • 积分膨胀资格扣分
      • 积分膨胀资格扣分-取消
    • 互动类活动
      • 互动类活动加分
      • 互动类活动扣分
      • 取消互动类活动加分
      • 取消互动类活动扣分
    • 积分抵现
      • 积分抵现
      • 取消 - 积分抵现
    • 积分券抵现
      • 积分券抵现
      • 取消 - 积分券抵现
      • 积分券加赠券派分
      • 取消-积分券加赠券派分
    • 积分兑礼
      • 积分兑礼
      • 取消 - 积分兑礼
    • 其他积分操作
      • 积分冻结
      • 积分解冻
      • 积分交易撤销
      • 消耗已冻结积分
      • 拆分积分分批冻结
    • 积分查询
      • 积分查询
      • 积分比例查询
      • 积分有效期明细
    • 积分变更接口
    • 明细查询
  • 标签场景
    • 标签目录列表
    • 标签列表
    • 打标
    • 去标
    • 用户标签列表
    • 分组下用户标签列表
    • 标签导入通知
  • 销售场景
    • 退单同步
    • 订单同步
    • 订单查询
    • 查询销售单会员
    • 查询会员消费件数
    • 线上订单(60580)通知计算积分
    • 订单换渠道ID
  • 权益场景
    • 自研礼券
      • 自研礼券项目同步Loyalty
      • 自研礼券 实例同步Loyalty
    • 权益礼品同步
    • 权益礼品详情查询
    • 核销
    • 优惠券列表
    • 已领取礼品列表查询
    • 会员可用券列表
    • 积分商城订单同步
    • 反核销
    • 券查询
    • 卡券发放
    • 券项目查询
    • 券项目列表
  • 活动场景
    • 微信报名活动
      • 微信活动详情
      • 微信活动报名
      • 微信活动签到
      • 根据memberId分页查询微信活动参与记录列表
      • 分页查询微信活动列表
    • 积分券活动
      • 积分券活动查询
    • 邀请有礼活动
      • 分页查询邀请有礼活动列表
      • 邀请有礼活动-绑定会员邀请申请码
      • 邀请有礼活动-详情
      • 邀请有礼活动资格验证
    • 互动类积分活动详情和参与记录
  • 企点
    • 积分变更接口
      POST
    • 券项目列表
      POST
    • 卡券批量发放
      POST
    • 标签导入通知
      POST
  1. 企点

券项目列表

POST
/fast-common-service/v1/0.0/api/coupon/project/list
卡券场景
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-common-service/v1/0.0/api/coupon/project/list' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjY3JtYV9wcmQtbG95YWx0eV9hcGlfcHJkIiwiYXVkIjoiY2NybWFfcHJkIiwiY2xpZW50SWRUbyI6ImxveWFsdHlfYXBpX3ByZCIsImRlc3RpbmF0aW9uRG9tYWluIjoiaHR0cHM6Ly9sb3lhcGkuY2hvd3RhaWZvb2suc3oiLCJjbGllbnRJZEZyb20iOiJjY3JtYV9wcmQiLCJzY29wZSI6Im9wZXJhdGUscXVlcnkiLCJpc3MiOiJjdGZfc3RhZmZfc3NvIiwiZXhwIjoxNzUwMTYzMjI2LCJpYXQiOjE3NTAxNTYwMjZ9.qsDa-N_vPUIBOMyBQrCzYO9L0Uvyx_os0pT2WPdRKRcBvz_1fHMI_zbBxt12u2TqJrQRuObSou8kFCE9NqwdOg' \
--header 'X-Caller-Service: ' \
--header 'X-Caller-Timestamp: ' \
--header 'X-Caller-Sign: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bizCode": "CTFCN",
    "requestChannel": "QD",
    "requestSystem": "QD",
    "transactionId": "TX2024030490569",
    "page": 0,
    "pageSize": 20,
    "queryParams": "{\"benefitGrade\":{\"EQ\":\"Tier0\"},\"type\":{\"EQ\":\"RegisterGift\"},\"status\":{\"EQ\":\"RELEASED\"}}",
    "sortBy": "updateTime",
    "sortType": "DESC"
}'
响应示例响应示例
{
    "success": true,
    "code": "000000",
    "message": "成功",
    "data": {
        "page": 0,
        "pageSize": 20,
        "total": 1,
        "data": [
            {
                "includeShops": null,
                "excludeShops": null,
                "includeGoods": null,
                "excludeGoods": null,
                "id": "dadgz6hi",
                "branch": "dadgz6hi",
                "title": "王乾测试资格券-续会好礼",
                "kind": "",
                "campaignTitle": "王乾测试资格券",
                "description": null,
                "status": "RELEASED",
                "restrict": null,
                "grantRestrict": {
                    "startAt": "2025-01-01 16:03:29",
                    "endAt": "2025-03-01 16:03:34",
                    "platformsRef": null,
                    "invokeNum": null,
                    "invokeNumByUserPerDay": null,
                    "invokeNumByPerDay": null
                },
                "useRestrict": {
                    "shopsRefType": null,
                    "shopsRef": null,
                    "platformsRef": null,
                    "goodsRefType": null,
                    "goodsRef": null,
                    "startAt": "2025-01-01 16:03:49",
                    "endAt": "2025-03-01 16:03:56",
                    "invokeNumByUserPerDay": null,
                    "wait": null,
                    "timeType": "FIXED_TIME",
                    "timeCycle": null
                },
                "cancelUseRestrict": {
                    "invokeNum": 1,
                    "invokeNumByUserPerDay": null,
                    "startAt": "2025-01-01 16:04:00",
                    "endAt": "2025-03-01 16:04:06"
                },
                "updateAt": "2025-01-09 10:12:43",
                "maxQuantity": 100,
                "useCountRestrict": 1,
                "transferable": null,
                "type": "RenewalGift",
                "discount": null,
                "exchange": {
                    "goods": "5",
                    "num": null,
                    "maxPerGoods": null
                },
                "maxOverlayNum": null,
                "combinationEnabled": false,
                "grantedCount": 0,
                "usedCount": 0,
                "reminderBeforeExpirationEnable": true,
                "reminderBeforeExpiration": {
                    "year": null,
                    "quarter": null,
                    "month": null,
                    "week": null,
                    "day": 7,
                    "hour": null,
                    "minute": null,
                    "second": null
                },
                "effectPeriod": {
                    "type": "RELATIVE_TIME",
                    "fixed": null,
                    "relatives": [
                        {
                            "scene": "activate",
                            "duration": {
                                "year": null,
                                "quarter": null,
                                "month": null,
                                "week": null,
                                "day": null,
                                "hour": null,
                                "minute": null,
                                "second": 0
                            },
                            "toDayBegin": false,
                            "toDayEnd": null,
                            "fixedPart": null
                        }
                    ]
                },
                "expiredPeriod": {
                    "type": "RELATIVE_TIME",
                    "fixed": null,
                    "relatives": [
                        {
                            "scene": "grant",
                            "duration": {
                                "year": null,
                                "quarter": null,
                                "month": 1,
                                "week": null,
                                "day": null,
                                "hour": null,
                                "minute": null,
                                "second": null
                            },
                            "toDayBegin": null,
                            "toDayEnd": false,
                            "fixedPart": null
                        }
                    ]
                },
                "template": "deyc9o1r",
                "codeMaker": "3rwu3e",
                "effectRestrict": null,
                "expireRestrict": null,
                "previous": null,
                "program": "dmcirekx",
                "subOrderShareDiscount": null,
                "combinationType": "NO_OVERLAY",
                "storeDirectDistribution": null,
                "transferRestrict": null,
                "transferPeriod": null,
                "weiMob": null,
                "weChatPayCouponStocks": null,
                "couponCost": null,
                "positivePriceGoods": null,
                "payBenefit": null,
                "storeLimitNum": null,
                "orderDeductList": null,
                "materialImage": null,
                "createNow": false,
                "activateNow": false,
                "subject": "dm3dgd27",
                "benefitGrade": "Tier1",
                "fqn": "benefit.dadgz6hi",
                "code": "dadgz6hi",
                "builtIn": false,
                "origin": "dadgz6hi",
                "insertAt": "2025-01-09T02:12:43.439Z",
                "_i18nPayload": {
                    "title": {
                        "zh-CN": "王乾测试资格券-续会好礼"
                    },
                    "campaignTitle": {
                        "zh-CN": "王乾测试资格券"
                    },
                    "description": {}
                },
                "available": true,
                "annotations": {
                    "exchange.goodsselectorValueText": "已选中 1 条数据"
                },
                "displayPriority": 1,
                "orgSystemCode": "0-",
                "explanation": "王乾测试资格券补充说明",
                "releaseAt": "2025-01-09T02:12:43.438Z",
                "createAt": "2025-01-09T02:12:20.786Z",
                "templateSnapshotId": "shotau8e",
                "updateBy": "wangqian",
                "codeExtOn": false,
                "audit": {
                    "releaseAt": "2025-01-09T02:12:43.437Z",
                    "releaseBy": "wangqian"
                },
                "ifPopup": true,
                "displayEndTime": "2025-03-31T08:02:29.000Z",
                "product": "deyc9o1r",
                "dataVersion": 0,
                "statusOfUse": "RELEASED",
                "module": "benefit",
                "pictureUrl": "http://content-management.shuyun.com/ad7ac8d0-fc53-4c30-b305-fb914ca550bc.png",
                "benefitGroup": "ExclusiveTreats",
                "displayStartTime": "2025-01-01T08:02:23.000Z",
                "releaseBy": "wangqian",
                "extSet": "benefit.project",
                "updateById": "67",
                "createBy": "wangqian",
                "statusOfEdit": "RELEASED",
                "domain": "benefit",
                "benefitDesc": "王乾测试资格券权益描述\n",
                "createById": "67",
                "since": "1.0"
            }
        ]
    }
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Authorization
string 
可选
默认值:
Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjY3JtYV9wcmQtbG95YWx0eV9hcGlfcHJkIiwiYXVkIjoiY2NybWFfcHJkIiwiY2xpZW50SWRUbyI6ImxveWFsdHlfYXBpX3ByZCIsImRlc3RpbmF0aW9uRG9tYWluIjoiaHR0cHM6Ly9sb3lhcGkuY2hvd3RhaWZvb2suc3oiLCJjbGllbnRJZEZyb20iOiJjY3JtYV9wcmQiLCJzY29wZSI6Im9wZXJhdGUscXVlcnkiLCJpc3MiOiJjdGZfc3RhZmZfc3NvIiwiZXhwIjoxNzUwMTYzMjI2LCJpYXQiOjE3NTAxNTYwMjZ9.qsDa-N_vPUIBOMyBQrCzYO9L0Uvyx_os0pT2WPdRKRcBvz_1fHMI_zbBxt12u2TqJrQRuObSou8kFCE9NqwdOg
X-Caller-Service
string 
可选
默认值:
{{caller}}
X-Caller-Timestamp
string 
可选
默认值:
{{currentTime}}
X-Caller-Sign
string 
网关签名
可选
默认值:
{{sign}}
Body 参数application/json
bizCode
string 
业务代码
必需
>= 1 字符
示例值:
CTFCN
requestChannel
string 
请求渠道 淘宝(TAOBAO) 京东(JD)抖音(DOUYIN) CTFMall PC 端(OFFICIAL_MALL) 港澳官网(GW) CRM后台(KYLIN_CRM) Sales APP(SalesAPP) Experience APP(ExperienceAPP) 鸿蒙APP(HarmonyAPP) 微信平台(WX) 快捷H5(KJH5) 港澳APP(VIPAPP) CTFMall M站(OFFICIAL_MALL_M) CTFMall支付宝小程序(OFFICIAL_MALL_ZFB)
必需
>= 1 字符
示例值:
WECHAT
requestSystem
string 
请求系统 P淘宝(TAOBAO) 京东(JD) 抖音(DOUYIN) 官方商城(OFFICIAL_MALL) 港澳官网(GW) CRM后台(KYLIN_CRM) Sales APP(SalesAPP) Experience APP(ExperienceAPP) 鸿蒙APP(HarmonyAPP) 会员中心小程序(WX) 快捷H5(KJH5) 港澳APP(VIPAPP) CTFMall微信小程序(OFFICIAL_MALL_WX) CTFMall M站(OFFICIAL_MALL_M) CTFMall支付宝小程序(OFFICIAL_MALL_ZFB)
必需
>= 1 字符
示例值:
WECHAT_MALL
transactionId
string 
事务ID
必需
>= 1 字符
示例值:
TX2024030490569
page
integer <int32>
当前页:从0开始
必需
默认值:
0
示例值:
0
pageSize
integer <int32>
页大小:不超过20
必需
默认值:
20
示例值:
20
queryParams
string 
查询条件参数
可选
查询条件参数是动态传入,例子:{"title":{"EQ":"openapi测试项目"},"status":{"EQ":"RELEASED"},"branch":{"IN":["2e3cc427"]},"updateAt":{"BETWEEN":["2022-10-21 14:24:28","2022-10-21 14:24:30"]}},可通过响应结果值中的属性名称过滤
sortBy
string 
排序字段
可选
默认值:
updateAt
sortType
string 
排序类型:ASC、DESC,不传默认为DESC
必需
>= 1 字符
示例

返回响应

🟢200成功
application/json
projectList 200 response
Body
success
boolean 
是否成功:true 表示成功 false 表示失败
可选
code
string 
000000 表示成功,其余编码表示具体错误编码
可选
message
string 
可选
data
object 
可选
page
integer <int32>
页码
可选
pageSize
integer <int32>
每页大小
可选
totalCount
integer <int64>
数据总数
可选
items
array[object (CouponProject) {60}] 
数据详情
可选
上一页
积分变更接口
下一页
卡券批量发放
Built with