精确查询客户联系人资料

【生产 1.20.3 新增；测试 1.20.2b0 暂不提供】

Required application Scope: client:read. 管理员授权的全局只读客户联系人投影，并非手机号认证。client_contact_id 或 phone 必须且只能提供一个，重复或未知参数均拒绝；不支持无条件列表、模糊或公司查询。phone 精确匹配主/备用手机号，不做号码规范化，禁止首尾空白；同一联系人两字段命中仍为一条。仅查询 is_deleted=false 的联系人及公司，排除无公司联系人。无匹配404 CONTACT_NOT_FOUND，多个不同联系人409 AMBIGUOUS_CONTACT。返回五个白名单字段，普通资料缺失保留null；不返回手机号、邮箱、微信、备注或认证信息。不自动授予既有应用权限，不改变 POST clients/resolve。

调用示例：GET /internal/v1/clients/?client_contact_id=1001 或 GET /internal/v1/clients/?phone=13800000000。每次请求使用独立 Nonce 和当前时间戳，签名须包含实际查询参数；已有 Apifox 全局签名前置脚本可沿用。示例均为虚构数据。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "message": null,
    "data": {
        "client_contact_id": 1001,
        "name": "李四",
        "company_id": 21,
        "company_name": "示例公司",
        "position": "研究经理"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠409

精确查询客户联系人资料

请求参数

请求示例代码

返回响应