获取外部联系人详情
POST
/topapi/extcontact/get最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取企业外部联系人的详细信息。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
user_id
string
必需
外部联系人的userId,可调用获取外部联系人列表接口获取。
示例
{
"user_id": "011250026469774889"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
object
查询结果。
title
string
职位。
share_dept_ids
array[number]
共享部门ID列表。
label_ids
array[number]
标签。
remark
string
备注。
address
string
地址。
name
string
姓名。
follower_user_id
string
可选
负责人的userId。
state_code
string
国家码。
company_name
string
公司名。
share_user_ids
array[string]
可选
共享员工userId列表。
mobile
string
可选
手机号。第三方企业应用不返回此参数。
userid
string
可选
外部联系人userId。
email
string
邮箱。
errcode
number
返回码。
errmsg
string
返回码描述。
request_id
string
请求ID。
示例
{
"result": {
"title": "string",
"share_dept_ids": [
0
],
"label_ids": [
0
],
"remark": "string",
"address": "string",
"name": "string",
"follower_user_id": "string",
"state_code": "string",
"company_name": "string",
"share_user_ids": [
"string"
],
"mobile": "string",
"userid": "string",
"email": "string"
},
"errcode": 0,
"errmsg": "string",
"request_id": "string"
}
最后修改时间: 2 年前