文档中心 > API类目 > 直通车API

taobao.universalbp.account.get.balance (获取账户余额,现金余额)

获取账户实时现金余额

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • universalBP
  • api业务线编码,查询账户余额bizCode必须是universalBP

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • top_account_balance_v_o
  • TopAccountBalanceVo
  • 结果集
  • └ rt_cash_balance
  • String
  • 999.99
  • 账户实时现金余额

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpAccountGetBalanceRequest req = new UniversalbpAccountGetBalanceRequest();
UniversalbpAccountGetBalanceRequest.TopServiceContext obj1 = new UniversalbpAccountGetBalanceRequest.TopServiceContext();
obj1.setBizCode("universalBP");
req.setTopServiceContext(obj1);
UniversalbpAccountGetBalanceResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_account_get_balance_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <top_account_balance_v_o>
            <rt_cash_balance>999.99</rt_cash_balance>
        </top_account_balance_v_o>
    </result>
</universalbp_account_get_balance_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部