# 查询客户列表（旧） #### 功能介绍 伙伴可以查询合作伙伴的客户信息列表。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口即将下线，"查询客户列表"新接口请参考[查询客户列表-ListSubCustomers](https://support.huaweicloud.com/api-bpconsole/mc_00021.html)。 #### Web UI 伙伴可以登录合作伙伴中心查询合作伙伴的客户信息列表。 1. 在伙伴中心顶部导航栏中选择"销售 \> 客户业务 \> 我的客户"。 2. 选择"客户列表"页签。 3. 设置查询条件，筛选出待查询的客户。 伙伴可以根据关联类型，关联时间，客户名称，业务员姓名，移动电话或者客户标签查询客户。 #### REST API 伙伴在伙伴销售平台可以查询合作伙伴的客户信息列表。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。 伙伴查询不存在的客户时，接口返回HTTPcode 200，响应返回空列表。 1. URI GET /v1.0/{partner_id}/partner/customer-mgr/detail 参数说明请参见下表。 | 参数 | 是否必选 | 取值范围 | 描述 | |:---|:---|:---|:---| | partner_id | 是 | 最大长度：64 | 合作伙伴ID（华为分配）。 获取方法请参见[如何获取合作伙伴ID（partner_id）](https://support.huaweicloud.com/api-bpconsole/offl_110001.html)。 | 2. 请求消息 请求参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | domain_name | 否 | String | 最大长度：64 | 客户登录名称（如果客户创建了子用户，此处需要填写主账号登录名称。关于主账号和子用户的具体介绍请参见[身份管理](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html)中"账号"和"IAM用户"的描述）。 支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询。 该字段不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。 | | corp_name | 否 | String | 最大长度：64 | 如果是企业实名认证的用户，这里填写企业名称。 如果是个人实名认证的用户，这里填写客户名称。 支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询。 该字段不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。 | | page_no | 否 | integer | - | 查询第N页。 默认第1页。 此参数不携带或携带值为空或携带值为null时，取值为1；不支持携带值为空串。 | | page_size | 否 | integer | \[1-100\] | 每页数量。 默认10，最多100。 此参数不携带或携带值为空或携带值为null时，取值为10；不支持携带值为空串。 | | label | 否 | String | 最大长度：64 | 标签，支持模糊查找。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询；不支持英文大小写模糊查询。 该字段不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。 | | cooperationType | 否 | String | \[1\|2\] | 关联类型： - 1：顾问销售 - 2：代售 注： 支持顾问销售和代售关联类型。 该字段不携带或携带值为空，不作为筛选条件；不支持携带值为空串或携带值为null。 | | cooperationTimeStart | 否 | String | 最大长度：20 | 关联时间区间段开始，UTC时间。 格式为：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2019-05-06T08:05:01Z"。 该参数需与cooperationTimeEnd搭配使用。 该参数不携带时不作为筛选条件，不支持携带值为空或携带值为空串或携带值为null。 | | cooperationTimeEnd | 否 | String | 最大长度：20 | 关联时间区间段结束，UTC时间。 格式为： yyyy-MM-dd'T'HH:mm:ss'Z'，如"2019-05-06T08:05:01Z"。 该参数需与cooperationTimeStart搭配使用。 该参数不携带时不作为筛选条件，不支持携带值为空或携带值为空串或携带值为null。 | 请求示例 ``` GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/detail HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ ``` 3. 响应消息 响应参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | error_code | 是 | String | 最大长度：16 | 状态码。 具体请参见[4]。 | | error_msg | 是 | String | 最大长度：1024 | 错误描述信息。 | | customer_info_list | 否 | List\ | - | 客户信息列表。 具体请参见[表1] | | count | 否 | Integer | - | 总记录数。 | 表1CustomerInfo | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | corp_name | 是 | String | 最大长度：128 | 公司名称。 | | domain_name | 是 | String | 最大长度：128 | 客户登录名称（如果客户创建了子用户，此处返回主账号登录名称）。 | | customer_id | 是 | String | 最大长度：64 | 客户账号ID。 | | start_time | 否 | String | 最大长度：20 | 入驻时间点。 UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ 其中，HH范围是0～23，mm和ss范围是0～59。 | | cooperation_type | 否 | String | 长度：1 | 合作模式。 1：顾问销售 2：代售 注： 仅支持顾问销售和代售关联类型。 | | label | 否 | String | 最大长度：64 | 标签，支持模糊查找。 | | telephone | 否 | String | 最大长度：20 | 客户电话号码。 | | verifiedStatus | 否 | String | 最大长度：5 | 实名认证状态： - -1：未实名认证； - 0：实名认证审核中； - 1：实名认证不通过； - 2：已实名认证； | | countryCode | 否 | String | 最大长度：10 | 国家码，电话号码的国家码前缀。 例如：中国 0086。 | 响应示例 ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "count": 2, "error_code": "CBC.0000", "error_msg": "success", "customer_info_list": [ { "customer_id": "7ff331de7af7457d8331de0bfe7a42b7", "corp_name": null, "domain_name": "mingcheng", "start_time": "2018-10-11T02:28:34Z", "cooperation_type": "1", "label": "xxx", "telephone": "139xxxxxxxx", "verifiedStatus": "-1", "countryCode": "xxxx" }, { "customer_id": "67b5223d4f6e4cc18d8dfd2da9d01db8", "corp_name": null, "domain_name": "ambrosiaxu", "start_time": "2018-06-25T11:15:20Z", "cooperation_type": "1", "label": "xxx", "telephone": "139xxxxxxxx", "verifiedStatus": "-1", "countryCode": "xxxx" } ] } ``` 4. 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 200 | CBC.0000 | 成功。 | | 500 | CBC.0999 | 其他错误。 | | 400 | CBC.0100 | 参数错误。 | | 403 | CBC.0151 | 访问拒绝。 |