更新时间:2023-03-31 GMT+08:00
分享

查询账户余额

功能介绍

客户可以查询自身的账户余额。

该接口即将下线,“查询账户余额”接口请参考查询账户余额

Web UI

客户登录费用中心进入“总览”页面,在“可用额度”区域可以查询自身的账户余额。

REST API

客户在自建平台查询自身的账户余额。

客户查询自身的账户余额的时候,只允许使用客户自身的AK/SK或者Token调用。

  1. URI

    GET /v1.0/{domain_id}/customer/account-mgr/balances

    参数说明请参见下表。

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

    此参数暂不校验

  1. 请求消息

    请求参数

    无。

    请求示例

    GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/balances HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见4

    error_msg

    String

    错误描述信息。

    account_balances

    List<AccountBalance>

    账户余额列表。

    具体请参见表2

    debtAmount

    Number

    欠款总金额。

    measureId

    Integer

    度量单位:

    • 1:元
    • 2:角
    • 3:分

    currency

    String

    币种。

    CNY:人民币。

    表2 AccountBalance

    参数

    参数类型

    描述

    account_id

    String

    账户标识。

    account_type

    Integer

    账户类型。

    • 1:余额
    • 2:信用
    • 5:奖励
    • 7:保证金

    amount

    Double

    余额。

    currency

    String

    币种。

    CNY:人民币。

    值为空代表人民币。

    designated_amount

    Double

    专款专用余额。

    credit_amount

    Double

    总信用额度,仅信用账户存在该字段。

    measure_unit

    Integer

    度量单位。

    1:元

    memo

    String

    备注。

    type

    String

    • 0:华为云账户
    • 1:伙伴拨款账户

      仅当客户关联合作伙伴且关联类型为代售模式时,才会存在伙伴拨款账户。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time  
    
    {
    	"error_code": "CBC.0000",
    	"error_msg": "success",
    	"account_balances": [{
    			"account_id": "AT001016B6A58D3D60",
    			"account_type": 1,
    			"amount": 20810.92,
    			"currency": "CNY",
    			"designated_amount": 14999.98,
    			"credit_amount": null,
    			"measure_unit": 1,
    			"memo": null,
    			"type": "1"
    		},
    		{
    			"account_id": "AT001016B6A58D3D81",
    			"account_type": 5,
    			"amount": 0,
    			"currency": "CNY",
    			"designated_amount": 0,
    			"credit_amount": null,
    			"measure_unit": 1,
    			"memo": null,
    			"type": "1"
    		}
    	],
    	"debtAmount": 0,
    	"measureId": 1,
    	"currency": "CNY"
    }

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

    HTTP状态码

    错误码

    描述

    200

    CBC.0000

    成功。

    500

    CBC.0999

    其他错误。

    403

    CBC.0151

    访问拒绝。

    400

    CBC.0100

    参数错误。

分享:

    相关文档

    相关产品