请登录后查看
ListConsumeSubCustomers
查询伙伴消费子客户列表
POST
https://bss.myhuaweicloud.com/v2/bills/subcustomer-bills/res-fee-records/sub-customers/query
只看必填项
填写默认值
密文显示特定参数
接口说明
伙伴在伙伴销售平台可实时查询消费账期内的子客户列表,可以用于查询子客户的消费记录。
说明: 若当前子客户与伙伴无关联关系,仍可查询账期内处于关联状态且有消费的子客户列表。
约束说明
该接口只允许使用合作伙伴AK/SK或者Token调用
URL
POST https://bss.myhuaweicloud.com/v2/bills/subcustomer-bills/res-fee-records/sub-customers/query
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
X-Language | string | header | 否 | 语言。中文:zh_CN英文:en_US缺省为zh_CN。 |
X-Auth-Token | string | header | 是 | 合作伙伴Token调用 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
bill_cycle | string | 是 | 账期所在月份。 格式:YYYY-MM |
offset | integer | 否 | 偏移量,从0开始。默认值为0。 说明: offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。 例如,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。 |
limit | integer | 否 | 一次查询的条数,默认值为10。 |
返回参数
返回码: 200
查询客户消费子客户列表响应
| 名称 | 类型 | 描述 |
|---|---|---|
sub_customers | Array of SubCustomerInfoV3 objects | 子客户列表。 具体请参见表SubCustomerInfo。 |
total_count | integer | 结果集数量,只有成功才返回这个参数。 |
200 sub_customers
| 名称 | 类型 | 描述 |
|---|---|---|
customer_id | string | 客户账号ID。 |
返回码: 400
|CBC.0100:参数错误|
请求示例
示例 1
"POST https://bss.myhuaweicloud.com/v2/bills/subcustomer-bills/res-fee-records/sub-customers/query?bill_cycle=2022-03&offset=0&limit=10"返回示例
返回码：200
查询客户消费子客户列表响应
示例 1
"sub_customers": [
{
"customer_id": "0501ed********b50f8cc00878383140"
}
],
"total_count": 1
}
SDK
点击 运营能力开放 (BSS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
本文导读
接口说明
约束说明
URL
请求参数
返回参数
请求示例
返回示例
SDK
错误码