更新时间:2022-11-15 GMT+08:00
分享

查询伙伴账户余额

功能介绍

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

接口约束

该接口只允许使用合作伙伴AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口。

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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数

参数类型

描述

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
        }
    ]
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

描述

200

CBC.5001

非合作伙伴。

400

CBC.99000037

您没有操作该云经销商的权限。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

相关文档