查询广告结算单列表
收藏接口说明
查询广告结算单列表
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v3/capacity/query_ad_settlement_list/ |
| HTTP Method | GET |
| Scope | ma.traffic.settlement |
| 权限要求 | 流量主结算 |
请求参数
请求头
access-token必填String
当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/ 生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/ 生成的token
content-type必填String
示例：application/json
固定值"application/json"
Query
monthString
示例：2006-01
结算月份，格式“2006-01”
statusInt32
示例：1
结算状态
- 0：未完成
- 1：已完成
请求示例
curl --location --request GET 'https://open.douyin.com/api/apps/v3/capacity/query_ad_settlement_list/?status=4389263867064752470&month=lvjv8Yp36U' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
错误码
log_id必填String
日志ID
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_no": 4923379978338322000, "err_msg": "WrbmT62sE5", "log_id": "cGIBmv7SMj", "data": { "settlement_list": [ { "settlement_serial": "1gONnYuPoY", "settlement_name": "p3ZDlVULhf", "settlement_period": "lFqUO3pDro", "tax_rate": 0.9478070115893914, "settlement_total_amount": 3557876216067772400, "status": 483181407522040400 } ] } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 11001 | appid无法解析 | 建议重试 |
| 200 | 11009 | 参数不合法或缺少参数 | 检查参数合法性 |
| 200 | 11016 | access_token不正确或者已过期 | 检查access_token合法性 |
| 200 | 40006 | 非法请求，请求 IP 不在第三方小程序应用 IP 地址白名单内 | 添加IP地址到白名单内或者配置白名单为空 |
| 200 | 40036 | 授权小程序未授予该接口对应的权限 | 引导商家授予相关权限集 |
