查询对账单

开发环境

http://dev-cn.your-api-server.com

POST

/api/promotion/v1/coupon/batch_rollback_consume_coupon

方便开发者快速对账，支持开发者通过本接口获取对账单离线下载地址。

使用限制

该接口数据每天10点半进行更新，且只可查询T-1到6个月内数据。

接口说明

获取用户单日领券记录，与本地记录进行比对，及时补充缺省的券数据，可防止资金亏损。

权限要求

需要申请权限。路径：

小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券

错误码

HTTP 状态码	错误码	描述	排查建议
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001007	参数不合法	检查请求参数是否填写正常
200	29005077	资源不存在	无对账数据

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/batch_rollback_consume_coupon' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bill_type":"receive_record",
    "bill_date": "20230405",
    "app_id": "ttec789ac573xxxxxx01"
}'

响应示例

200 - 成功示例

{
  "err_no": 0,
  "err_msg": "",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "bill_download_url": "https://p0-open-promotion-private.byteimg.com/tos-cn-i-gyhr0m0lve/20160405_tt123456789_coupon_record.csv"
  }
}

修改于 2023-11-30 07:10:26

查询券模板

创建开发者接口发券活动

查询对账单

使用限制#

接口说明#

错误码#

请求参数

返回响应

使用限制

接口说明

错误码