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

    收藏
    我的收藏

    接口说明

    查询小游戏广告金账户余额信息,可用于广告金管理、转充决策和账户核对。

    基本信息

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

    请求参数

    请求头
    content-type必填String
    固定值"application/json"
    Body展开全部子属性
    Common必填Struct
    展开子属性
    BaseStruct
    展开子属性
    请求示例
    curl --location 'https://minigame.zijieapi.com/mgplatform/api/apps/ad/income/query' \ --header 'access-token: 080112184749375a6a41694d4c7a685a4a657961734f42696c773d3d' \ --header 'Content-Type: application/json' \ --data '{ "Common": { "access-token": "08011218474a454c517252594d56446a787a37564775695747673d3d", "mp_id": "tta682d03f39b2471b07", "Base": { "LogID": "202408212023569E4E311CD0F1CC3BF7B7", "Caller": "", "Addr": "", "Client": "", "TrafficEnv": { "Open": false, "Env": "" }, "Extra": { "": "" } } }, "Base": { "LogID": "202408212023569E4E311CD0F1CC3BF7B7", "Caller": "", "Addr": "", "Client": "", "TrafficEnv": { "Open": false, "Env": "" }, "Extra": { "": "", "env": "prod" } } }'

    响应参数

    Body展开全部子属性
    BaseResp必填Struct
    展开子属性
    itemsStruct
    展开子属性
    traceStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "Items": { "MpID": "tta682d03f39b2471b07", "AvailableBalance": 19920.72, "ExpiringBalance": 0 }, "Trace": { "LogID": "202602042035214B0B1C4B25F082E94B63" }, "BaseResp": { "StatusMessage": "success", "StatusCode": 0 } }
    切换单列布局

    错误码

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