权益礼品详情查询

curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-service/v1/0.0/api/benefit/benefitGift/get' \ --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": "WX", "requestSystem": "WX", "transactionId": "TX2024030490569", "giftCodes": [ "639811","F09DAFDC-33D6-4584-94F4-68C4CDDFE5CD","123" ] }'

{ "success": true, "code": "string", "message": "string", "data": [ { "giftCode": "24101", "giftName": "国萃传承【祥瑞长春】黄金翡翠吊坠", "giftType": "physicalGift", "pictureUrl": "http://content-management.shuyun.com/ad7ac8d0-fc53-4c30-b305-fb914ca550bc.png", "thumbnailUrl": "http://content-management.shuyun.com/ad7ac8d0-fc53-4c30-b305-fb914ca550bc.png", "copywritingDescription": "文案描述", "description": "备注", "ifEffect": true, "giftDesc": "礼品说明", "ifPopup": true } ] }

请求参数

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

giftCodes

array[string]

礼品编号

必需

>= 1 items

示例

返回响应

🟢200成功

application/json

benefitGiftListGet 200 response

Body

success

boolean

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

可选

code

string

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

可选

message

string

可选

data

array[object (BenefitGiftListGetResult) {10}]

可选

giftCode

string

礼品编号

必需

>= 1 字符

示例值:

24101

giftName

string

礼品名称

必需

>= 1 字符

示例值:

国萃传承【祥瑞长春】黄金翡翠吊坠

giftType

string

礼品类型

必需

physicalGift实物礼品、virtualGifts虚拟礼品、ctfCoupon礼券

>= 1 字符

示例值:

physicalGift

pictureUrl

string

图片链接

可选

示例值:

http://content-management.shuyun.com/ad7ac8d0-fc53-4c30-b305-fb914ca550bc.png

thumbnailUrl

string

缩略图链接

可选

示例值:

http://content-management.shuyun.com/ad7ac8d0-fc53-4c30-b305-fb914ca550bc.png

copywritingDescription

string

文案描述

可选

示例值:

文案描述

description

string

备注

可选

示例值:

备注

ifEffect

boolean

是否有效

可选

示例值:

true

giftDesc

string

礼品说明

可选

示例值:

礼品说明

ifPopup

boolean

是否弹窗

可选

示例值:

true