更新时间:2024-09-26 GMT+08:00

查询客户列表(旧)

功能介绍

伙伴可以查询合作伙伴的客户信息列表。

该接口即将下线,“查询客户列表”新接口请参考查询客户列表

Web UI

伙伴可以登录合作伙伴中心查询合作伙伴的客户信息列表。

  1. 在伙伴中心顶部导航栏中选择“销售 > 客户业务 > 我的客户”。
  2. 设置查询条件,筛选出待查询的客户。

    伙伴可以根据关联类型,关联时间,客户名称,业务员姓名,移动电话或者客户标签查询客户。

REST API

伙伴在伙伴销售平台可以查询合作伙伴的客户信息列表。

该接口只允许使用合作伙伴账号AK/SK或者Token调用。

伙伴查询不存在的客户时,接口返回HTTPcode 200,响应返回空列表。

  1. URI

    GET /v1.0/{partner_id}/partner/customer-mgr/detail

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    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"
            }
      ]
    }

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

    HTTP状态码

    错误码

    描述

    200

    CBC.0000

    成功。

    500

    CBC.0999

    其他错误。

    400

    CBC.0100

    参数错误。

    403

    CBC.0151

    访问拒绝。