查询伙伴账户余额-ListPartnerBalances

功能介绍

合作伙伴可以查询伙伴的账户余额。

接口约束

该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见为组织人员分配权限。

接口对应的权限项如下：

权限项	权限项名称
BPC_ITEM_VIEW_010100\|BPC_ITEM_SUBCUSTSERV_010103\|BPC_ITEM_SUBCUSTSERV_010104\|BPC_ITEM_SALES_020104\|BPC_ITEM_SALES_020105	主页-账号销售-客户-客户管理-客户列表-拨款销售-客户-客户管理-客户列表-回收销售-云经销商-云经销商管理-我的二级分销商列表-拨款销售-云经销商-云经销商管理-我的二级分销商列表-回收

URI

GET /v2/accounts/partner-accounts/balances

参数说明请参见下表。

表1 查询参数
参数	是否必选	参数类型	取值范围	描述
indirect_partner_id	否	String	最大长度：64	云经销商ID。获取方法请参见查询云经销商列表。华为云总经销商（一级经销商）查询云经销商（二级经销商）余额时，需要携带该参数；除此之外，此参数不做处理。否则只能查询自己的账户余额。

请求消息

请求参数

无。

请求示例

GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/balances?indirect_partner_id=0977ffa9f20010790f0fc003f6900520 HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数	参数类型	描述
error_code	String	状态码。具体请参考状态码。只有失败才返回该字段。
error_msg	String	错误描述信息。只有失败才返回该字段。
account_balances	List<AccountBalance>	账户余额列表。具体请参见表2

参数

参数类型

描述

error_code

String

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

错误描述信息。只有失败才返回该字段。

account_balances

List<AccountBalance>

账户余额列表。

具体请参见表2

表2 AccountBalance
参数	参数类型	描述
account_id	String	账户标识。
account_type	Integer	账户类型： 1：余额 2：信用 5：奖励 7：保证金 8：可拨款
amount	Double	账户余额。
currency	String	币种。 CNY：人民币。
measure_id	Integer	度量单位。 1：元。
designated_amount	Double	专款专用余额。
credit_amount	Double	总信用额度。只有account_type取值为2时，该字段才有效。
memo	String	备注。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "account_balances": [
        {
            "account_id": "AT0010169C22C887F8",
            "account_type": 1,
            "amount": 100,
            "currency": "CNY",
            "designated_amount": 0.0,
            "credit_amount": 0.0,
            "measure_id": 1,
            "memo": null
        }
    ]
}