3.4 根据企微external_userid获取企微好友详情

请求参数

Query 参数

access_token

string

调用接口凭证

必需

external_userid

string

必需

企微的外部联系人id

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://openapi.weiling.cn/openapi/customer/get_by_external_userid?access_token&external_userid'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

customer_id

string

必需

企微好友的userid

external_userid

string

必需

企微的外部联系人id

name

string

企微好友的名称

必需

avatar

string

企微好友头像

必需

type

integer

必需

企微好友类型，1标识该外部联系人是微信用户，2表示该外部联系人是企业微信用户

gender

integer

必需

企微好友性别 0-未知 1-男性 2-女性

position

string

可选

企微好友的职位，如果外部企业或者用户选择隐藏职位，则不返回

corp_name

string

可选

企微好友所在企业的简称

corp_full_name

string

可选

企微好友所在企业的主体名称

remark_mobiles

array[string]

可选

员工对此企微好友备注的手机号码，数组格式

lost_state

boolean

必需

企微好友是否流失，false未流失，true已流失

union_id

string

可选

企微好友自建应用的union_id

follow_users

array [object {10}]

必需

添加了此企微好友的员工

company_list

array [object {2}]

可选

企微好友所在企业列表

business_list

array [object {2}]

商机列表

可选

clue_list

array [object {1}]

关联线索列表

可选

示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "customer_id": "ocjvujojkvbhyj",
        "external_userid": "wmWAFzDwAA04t0V_f4jnJRkTQAQ",
        "name": "张三",
        "avatar": "",
        "type": 1,
        "gender": 1,
        "position": "研发",
        "corp_name": "上海卫瓴科技",
        "corp_full_name": "",
        "remark_mobiles": [],
        "lost_state": 0,
        "unionid": "xxxxxxxx",
        "follow_users": [
            {
                "userid": "lkjcjvjkfjkljj",
                "remark_corp_name": "",
                "add_way": 1,
                "description": "dsfafergreg",
                "remark": "张三",
                "lost_state": 1,
                "add_source": {
                    "type": 1,
                    "id": "r8Q5kL9KeVBfGlkm664vRDL9vkWQUwx7cYRWfoEjL_k",
                    "name": "官网智能码"
                },
                "create_time": 1629098403000,
                "tags": [
                    {
                        "group_id": "r8Q5kL9KeVBfGlkm664vRDL9vkWQUwx7cYRWfoEjL_k",
                        "group_name": "标签分组名称",
                        "tag_id": "etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
                        "tag_name": "标签名称",
                        "type": 1
                    },
                    {
                        "group_id": "r8Q5kL9KeVBfGlkm664vRDL9vkWQUwx7cYRWfoEjL_k",
                        "group_name": "标签分组名称",
                        "tag_id": "etAJ2GCAAAXtWyujaJJJKLJKLii0mACHBVD",
                        "tag_name": "标签名称",
                        "type": 2
                    }
                ]
            }
        ],
        "company_list": [
            {
                "company_id": "sbpfPAn6Q5kxLWTvk29Gi88eywDHXMA9hmYqMxyCmlk",
                "company_name": "北京同一人基业投资管理有限公司"
            },
            {
                "company_id": "YeOrweB8SEOW1UAVa5o26fBfr85e0sIpYfyXQ_UtZDw",
                "company_name": "上海如呀信息咨询中心"
            },
            {
                "company_id": "YWZSC-sfQuJ6YnSKIhkgklrEDR1iRNXHm7kZwUXXfCk",
                "company_name": "深圳市微领科技有限公司"
            },
            {
                "company_id": "ugLA-FEUNn1DfYO9e3D0tRDmIvlo-pibhsv3XdstdK8",
                "company_name": "宁波宇涵教育科技有限公司"
            },
            {
                "company_id": "VcDV6cgIFZuUi-JdiO8SCGpLYJT23ytdAPtXYYV_B_E",
                "company_name": "中国船舶集团有限公司"
            }
        ]
    }
}