查询收支明细
功能介绍
伙伴在伙伴销售平台上查询自身的收支明细情况。
接口约束
该接口只允许使用合作伙伴AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/accounts/partner-accounts/account-change-records
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
balance_type |
是 |
String |
[BALANCE_TYPE_DEBIT|BALANCE_TYPE_CREDIT] |
账户类型。
|
|
trade_type |
否 |
String |
[RECHARGE|DEDEUCT|REFUND|RFROZEN|TRANS|ADJUST|BEADJUST|BERETRIEVE|BEUNBIND|BONUSCONVERT|TRADE_MODE_TRANSFER] |
交易类型。
此参数不携带或携带值为空时，不作为筛选条件。 |
|
trade_time_begin |
否 |
String |
最大长度：10 |
查询收支明细的开始日期。
说明：
|
|
trade_time_end |
否 |
String |
最大长度：10 |
查询收支明细的结束日期。
说明：
|
|
offset |
否 |
Integer |
[0-最大整数] |
偏移量，从0开始。默认值为0。
说明：
offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 |
|
limit |
否 |
Integer |
[1-100] |
每次查询的数量，默认值为10。 |
|
indirect_partner_id |
否 |
String |
最大长度：64 |
云经销商ID。获取方法请参见查询云经销商列表。
说明：
华为云总经销商（一级经销商）查询云经销商（二级经销商）的收支明细时，需携带此参数；除此之外，此参数不作处理。否则只能查询自身的收支明细。 |
请求消息
请求参数
无
请求示例
GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/account-change-records?balance_type=BALANCE_TYPE_DEBIT&trade_type=RECHARGE&trade_time_begin=2020-10-20&trade_time_end=2021-10-20&offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
error_code |
String |
最大长度：20 |
状态码。具体参见状态码。只有失败才会返回这个参数。 |
|
error_msg |
String |
最大长度：2000 |
错误描述信息。只有失败才会返回这个参数。 |
|
total_count |
Integer |
- |
返回总条数。 |
|
currency |
String |
最大长度：4 |
币种。 CNY：人民币。 |
|
records |
List<AccountChangeRecord> |
- |
调账记录列表。 具体请参见表2。 |
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
account_change_id |
String |
最大长度：128 |
收支明细流水号。 |
|
trade_detail_type |
String |
最大长度：128 |
交易详细类型。
|
|
trade_time |
String |
最大长度：20 |
交易时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2016-03-28T14:45:38Z”。 |
|
trade_id |
String |
最大长度：128 |
交易ID/订单ID。 |
|
change_amount |
String |
最大长度：64 |
变更金额，单位为元。 |
|
balance_after_change |
String |
最大长度：64 |
变更后余额，单位为元。 |
|
type |
String |
最大长度：64 |
收支类型。
|
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"total_count": 1,
"currency": "CNY",
"records": [
{
"account_change_id": "AC-8500000373-0",
"trade_detail_type": "SOURCE_OPERAIION_RECHARGE",
"trade_time": "2021-04-02T06:05:38Z",
"trade_id": "CB123456",
"change_amount": "1053.35",
"balance_after_change": "0.00",
"type": "1"
}
]
}
