查询用户可用券信息
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/promotion/v1/coupon/get_coupon_receive_info
权限要求
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access-token |
| 200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |
| 200 | 29005071 | No Permission Operate | 没有权限调用该接口，检查申请access-token的client_key是否与app_id一致 |
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/get_coupon_receive_info' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id":"ttcfdbb96650exxxx",
"open_id":"Cv4PoJXaTPnxxxx",
"coupon_status": 10
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "",
"log_id": "202304201146560B814XXXDB9D0B051956",
"data": {
"coupon_receive_list": [
{
"discount_type": 2,
"receive_desc": "领取描述",
"valid_end_time": 1678716000,
"talent_open_id": "Cv4PoJXaxxx63rNu",
"valid_begin_time": 1678705200,
"consume_path": "pages/index/index",
"coupon_id": "720998824905xxxx532",
"coupon_status": 10,
"discount_amount": 1000,
"min_pay_amount": 10,
"consume_desc": "使用描述",
"coupon_name": "券名称",
"merchant_meta_no": "merchant_demo",
"talent_account": "473945xxx83",
"receive_time": 1678709372
}
]
}
}请求参数
Header 参数
access-token
string
必需
示例值:
clt.xxx
Content-Type
string
必需
示例值:
application/json
Body 参数application/json