查询广告收入
收藏接口说明
查询广告收入
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v3/capacity/query_ad_income/ |
| 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
end_date必填String
示例：2006-01-02
结束日期，格式“2006-01-02”，查询时间范围不能超过90天
start_date必填String
示例：2006-01-02
开始日期，格式“2006-01-02”
host_nameString
宿主APP
- douyin-抖音
- douyin_lite-抖音lite
- toutiao-今日头条
- tt_lite-今日头条lite
- huoshan-抖音火山版；
请求示例
curl --location --request GET 'https://open.douyin.com/api/apps/v3/capacity/query_ad_income/?end_date=l1Xchm84Gl&host_name=Vlcr6cBEmd&start_date=82lLDQFOM2' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
错误码
log_id必填String
日志ID
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_msg": "CrLr4ExZqG", "log_id": "fraJu7HGN1", "data": { "income_list": [ { "date": "OGoN4NAuNe", "income": 7332774588276281000 } ] }, "err_no": 3305188676444290600 }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 11001 | appid无法解析 | 建议重试 |
| 200 | 11009 | 参数不合法或缺少参数 | 检查参数合法性 |
| 200 | 11016 | access_token不正确或者已过期 | 检查access_token合法性 |
| 200 | 40006 | 非法请求，请求 IP 不在第三方小程序应用 IP 地址白名单内 | 添加IP地址到白名单内或者配置白名单为空 |
| 200 | 40036 | 授权小程序未授予该接口对应的权限 | 引导商家授予相关权限集 |
