按照ID列表批量获取联系人数据

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，根据联系人实例id列表批量获取联系人数据，最多可一次获取200条数据。

调用本接口，可按照ID列表批量获取联系人数据，包括创建人的用户userId、数据ID、数据内容等。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	获取CRM主数据的接口访问权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

curl --location --request POST 'https://oapi.dingtalk.com/topapi/crm/objectdata/contact/list?access_token=dc73axxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "current_operator_userid": "manager1", "data_id_list": "nst_Id1, inst_Id2", "provider_corpid": "dingxxxx" }'

{ "result_list": [ { "creator_userid": "user1", "data": "{\"contact_related_customer\":{\"extendValue\":\"{\\\"quote\\\":\\\"1\\\",\\\"bizType\\\":\\\"crm_customer\\\",\\\"list\\\":[{\\\"instanceId\\\":\\\"c5baeea7-58de-4b61-882b-902aafd0b212\\\"}]}\",\"value\":\"[\\\"1\\\"]\"},\"contact_name\":\"联系人1\",\"contact_position\":{\"extendValue\":\"[{\\\"label\\\":\\\"老板\\\",\\\"key\\\":\\\"option_1\\\"}]\",\"value\":\"[\\\"老板\\\"]\"},\"contact_phone\":{\"extendValue\":\"{\\\"mode\\\":\\\"phone\\\",\\\"countryKey\\\":\\\"CN\\\",\\\"flag\\\":\\\"C\\\",\\\"countryCode\\\":\\\"+86\\\",\\\"areaNumber\\\":\\\"\\\",\\\"flagPy\\\":\\\"Z\\\",\\\"countryName\\\":\\\"China\\\",\\\"countryNameZh\\\":\\\"中国\\\",\\\"countryNamePy\\\":\\\"ZHONGGUO\\\"}\",\"value\":\"136********\"}}", "extend_data": "{\"contactUserId\":\"userId02\",\"contactUnionId\":\"unionId02\"}", "gmt_create": "2020-09-15 00:00:00", "gmt_modified": "2020-09-15 00:00:00", "instance_id": "inst_Id1", "object_type": "crm_contact", "permission": { "owner_userid_list": [ "user01", "user02" ], "participant_userid_list": [ "user01", "user02" ] } } ], "errcode": 0, "errmsg": "ok" }

请求参数

Query 参数

access_token

必需

调用服务端接口的授权凭证，可通过调用access_token接口获得。

示例值:

dc73axxxx

Body 参数application/json

current_operator_userid

string

可选

操作人用户userid。

data_id_list

string

必需

数据ID列表，可通过批量获取联系人数据接口获取。

provider_corpid

string

可选

自建应用时传入服务商corpId。

示例

返回响应

🟢200成功

application/json

Body

result_list

array [object {8}]

实例数据。

可选

gmt_modified

string

修改时间。

可选

creator_userid

string

可选

创建人的用户userid。

instance_id

string

数据ID。

可选

data

string

数据内容。

可选

extend_data

string

扩展数据内容。

可选

gmt_create

string

记录创建时间。

可选

object_type

string

数据类型。

可选

permission

object

数据权限信息。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

按照ID列表批量获取联系人数据

权限#

请求参数

返回响应

权限