3.4 根据企微external_userid获取企微好友详情
GET
https://openapi.weiling.cn/openapi/customer/get_by_external_userid请求参数
Query 参数
access_token
string
调用接口凭证
external_userid
string
必需
企微的外部联系人id
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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": "中国船舶集团有限公司"
}
]
}
}
最后修改时间: 1 年前