查询券模板
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/promotion/v1/coupon/get_coupon_meta
权限要求
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 接口请求成功，无需排查 |
| 200 | 29005013 | 券模板不存在 | 确认券模板id是否正确 |
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 28001007 | 参数不合法 | 检查请求参数是否填写正常 |
| 200 | 29005071 | No Permission Operate | 没有权限对券模板id进行操作,检查申请access-token的client_key是否与app_id一致 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/get_coupon_meta' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id": "ttec789ac573xxxxxx01",
"coupon_meta_id": "702345xxxxxx",
"merchant_meta_no": "123xxxxxx"
}'响应示例响应示例
200 - 成功示例
{
"data": {
"consume_path": "111",
"receive_begin_time": 1696649954,
"receive_desc": "领取须知文本",
"callback_url": "https://cloudxxxnet/faas/services/ttbxzm/invoke/opxxxxk",
"min_pay_amount": 110000,
"receive_limit": 1,
"coupon_task_type": 6,
"discount_amount": 100000,
"name": "api",
"receive_end_time": 1697168347,
"app_id": "ttcfdbb9xxxx33350",
"consume_desc": "样例",
"coupon_meta_id": "7288582xxxx9948325",
"default_path": "",
"discount_type": 5,
"merchant_meta_no": "1343234322202983",
"scene_desc": "测试openapi",
"secret_source": 1,
"status": 2,
"publish_status": 1,
"send_desc": "样例",
"share_fission_config": {
"award_coupon_id": "7288583218444533xxx",
"award_coupon_name": "样例",
"award_coupon_num": 1,
"award_type": 1
},
"valid_begin_time": 1696649954,
"valid_end_time": 1696995548,
"valid_type": 2,
"send_scene": 4,
"stock_number": 1000,
"valid_duration": 1
},
"err_msg": "",
"err_no": 0,
"log_id": "02169701003897500000000000000000000ffff0acb8266dff06d"
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
示例值:
clt.xxx
Body 参数application/json
返回响应
🟢200成功
🟠400请求有误