查询客户列表(旧)
Web UI
伙伴可以登录合作伙伴中心查询合作伙伴的客户信息列表。
- 在伙伴中心顶部导航栏中选择“销售 > 客户业务 > 我的客户”。
- 设置查询条件,筛选出待查询的客户。
伙伴可以根据关联类型,关联时间,客户名称,业务员姓名,移动电话或者客户标签查询客户。
REST API
伙伴在伙伴销售平台可以查询合作伙伴的客户信息列表。
该接口只允许使用合作伙伴账号AK/SK或者Token调用。
伙伴查询不存在的客户时,接口返回HTTPcode 200,响应返回空列表。
- URI
GET /v1.0/{partner_id}/partner/customer-mgr/detail
参数说明请参见下表。
参数
是否必选
取值范围
描述
partner_id
是
最大长度:64
合作伙伴ID(华为分配)。
获取方法请参见如何获取合作伙伴ID(partner_id)。
- 请求消息
参数
是否必选
参数类型
取值范围
描述
domain_name
否
String
最大长度:128
客户登录名称(如果客户创建了子用户,此处需要填写主账号登录名称。关于主账号和子用户的具体介绍请参见身份管理中“账号”和“IAM用户”的描述)。
支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配;不支持携带空格查询。
该字段不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
corp_name
否
String
最大长度:128
如果是企业实名认证的用户,这里填写企业名称。
如果是个人实名认证的用户,这里填写客户名称。
支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配;不支持携带空格查询。
该字段不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
page_no
否
Intger
-
查询第N页。
默认第1页。
此参数不携带或携带值为空或携带值为null时,取值为1;不支持携带值为空串。
page_size
否
Intger
[1-100]
每页数量。
默认10,最多100。
此参数不携带或携带值为空或携带值为null时,取值为10;不支持携带值为空串。
label
否
String
最大长度:64
标签,支持模糊查找。仅支持前缀匹配、后缀匹配、中间匹配;不支持携带空格查询;不支持英文大小写模糊查询。
该字段不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
cooperationType
否
String
[1|3]
关联类型:
- 1:顾问销售
- 2:代售
- 3:转售
注:
目前仅支持顾问销售和转售关联类型。
该字段不携带或携带值为空,不作为筛选条件;不支持携带值为空串或携带值为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-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/detail HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
- 响应消息
参数
是否必选
参数类型
取值范围
描述
error_code
是
String
最大长度:16
状态码。
具体请参见4。
error_msg
是
String
最大长度:1024
错误描述信息。
customer_info_list
否
List<CustomerInfo>
-
客户信息列表。
具体请参见表1
count
否
Integer
-
总记录数。
表1 CustomerInfo 参数
是否必选
参数类型
取值范围
描述
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:代售
3:转售
注:
目前仅支持顾问销售和转售关联类型。
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" } ] }