抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端API介绍
  • 小游戏 OpenAPI SDK 总览
  • 接口调用凭证
  • 登录
  • 开放数据
  • 二维码
  • 订阅消息
  • 消息推送客服
  • 游戏礼包
  • 游戏内容安全
  • 推荐流直出游戏能力
  • 社交互动能力
  • 动态分享
  • 消息推送
  • 抖音客服平台-客服能力
  • Schema链接
  • 公会群解绑
  • 游戏群标签能力
  • 上报赛事报名用户
  • 选手排名上报
  • 广告变现数据开放API
  • 流量主广告数据查询
  • 广告金账户余额查询
  • 广告金赠送金额查询
  • 广告金转充流水查询
  • 广告金赠送金额查询

    收藏
    我的收藏

    接口说明

    暂无

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/ad/gift/query
    HTTP Method
    POST
    Scope
    open.ttgame.mgplatform
    权限要求
    广告金赠送金额接口

    请求参数

    请求头
    content-type必填String
    固定值"application/json"
    Body展开全部子属性
    Common必填Struct
    展开子属性
    end_date必填String
    结束日期 yyyy-MM-dd
    Page必填Struct
    展开子属性
    start_date必填String
    开始日期 yyyy-MM-dd
    BaseStruct
    展开子属性
    income_typeString
    收入类型,如果不传递收入类型,将默认返回全部类型的数据 枚举: IAA:IAA收入广告金 IAP:IAP收入广告金 IAALimitTime:IAA收入广告金限时激励
    请求示例
    curl --location 'https://minigame.zijieapi.com/mgplatform/api/apps/ad/gift/query' \ --header 'access-token: 080112184749375a6a41694d4c7a685a4a657961734f42696c773d3d' \ --header 'Content-Type: application/json' \ --data '{ "Common": { "access-token": "", "mp_id": "tt411d37a0de37d565", "Base": { "LogID": "202408212023569E4E311CD0F1CC3BF7B7", "Caller": "", "Addr": "", "Client": "", "TrafficEnv": { "Open": false, "Env": "" }, "Extra": { "": "" } } }, "start_date": "2025-12-01", "end_date": "2026-08-01", "income_type": "", "Page": { "page_no": 1, "page_size": 100 }, "Base": { "LogID": "202408212023569E4E311CD0F1CC3BF7B7", "Caller": "", "Addr": "", "Client": "", "TrafficEnv": { "Open": false, "Env": "" }, "Extra": { "": "", "env": "prod" } } }'

    响应参数

    Body展开全部子属性
    BaseResp必填Struct
    展开子属性
    itemsList
    展开子属性
    PageStruct
    展开子属性
    traceStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "Items": [ { "SettleDate": "2025年7月1日至31日", "IncomeType": "IAA收入广告金限时激励", "GiftAmount": 300000, "ExpireDate": "2026-01-17 17:18:01" }, { "SettleDate": "2025年01月16日", "IncomeType": "IAP收入广告金", "GiftAmount": 1.21, "ExpireDate": "2025-10-18 00:00:00" } ], "Page": { "Total": 2 }, "Trace": { "LogID": "2026020117031606C23E47C65DA26194F5" }, "BaseResp": { "StatusMessage": "success", "StatusCode": 0 } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001016
    当前应用已被封禁或下线
    clientKey被封禁或者下线
    20028001006
    网络调用错误,请重试
    重试即可
    20028001014
    应用未授权任何能力
    确认应用是否授权能力
    20028001018
    应用未获得该能力
    开通相关能力
    20028003017
    quota已用完
    联系平台处理
    20028001019
    应用该能力已被封禁
    该能力被封禁,联系平台处理
    20028001007
    参数不合法
    根据错误信息检查请求参数是否填写正常
    20028001429
    qps超限
    20028001451
    查询范围超限