卡券批量发放 - CFT-周大福

curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-common-service/v1/0.0/api/coupon/grant/batch' \ --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": "WECHAT", "requestSystem": "WECHAT_MALL", "transactionId": "TX2024030490569", "holders": [ "string" ], "projectId": "string", "grantNum": 1, "grantShop": "string", "grantReason": "string" }'

{ "success": true, "code": "string", "message": "string", "data": [ { "memberId": "string", "id": "string", "projectId": "string", "code": "string", "grantAt": "2019-08-24T14:15:22.123Z", "state": "string" } ] }

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

可选

默认值:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjY3JtYV9wcmQtbG95YWx0eV9hcGlfcHJkIiwiYXVkIjoiY2NybWFfcHJkIiwiY2xpZW50SWRUbyI6ImxveWFsdHlfYXBpX3ByZCIsImRlc3RpbmF0aW9uRG9tYWluIjoiaHR0cHM6Ly9sb3lhcGkuY2hvd3RhaWZvb2suc3oiLCJjbGllbnRJZEZyb20iOiJjY3JtYV9wcmQiLCJzY29wZSI6Im9wZXJhdGUscXVlcnkiLCJpc3MiOiJjdGZfc3RhZmZfc3NvIiwiZXhwIjoxNzUwMTYzMjI2LCJpYXQiOjE3NTAxNTYwMjZ9.qsDa-N_vPUIBOMyBQrCzYO9L0Uvyx_os0pT2WPdRKRcBvz_1fHMI_zbBxt12u2TqJrQRuObSou8kFCE9NqwdOg

X-Caller-Service

string

可选

默认值:

X-Caller-Timestamp

string

可选

默认值:

X-Caller-Sign

string

网关签名

可选

默认值:

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

holders

array[string]

持有人

必需

>= 1 items<= 1000 items

projectId

string

项目Id

必需

>= 1 字符

grantNum

integer <int32>

发放数量:最小1最大限制默认是20

必需

>= 1<= 20

默认值:

grantShop

string

发放店铺

可选

grantReason

string

发放原因

可选

示例

返回响应

🟢200成功

application/json

grantBatch 200 response

Body

success

boolean

是否成功：true 表示成功 false 表示失败

可选

code

string

000000 表示成功，其余编码表示具体错误编码

可选

message

string

可选

data

array[object (Coupon) {6}]

可选

memberId

string

麒麟会员ID

可选

string

卡券实例ID

可选

projectId

string

项目ID

必需

>= 1 字符

code

string

卡券券码

必需

>= 1 字符

grantAt

string <date-time>

发放时间:8时区格式

可选

state

string

实例状态

可选