根据指定条件查询联系人数据

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

调用本接口，根据指定查询条件批量获取联系人数据，最多可一次获取200条数据。

调用本接口，可根据指定条件查询联系人数据。

权限

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

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

curl --location --request POST 'https://oapi.dingtalk.com/topapi/crm/objectdata/contact/query?access_token=dc73axxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "cursor":"0", "query_dsl":"{\"queryGroupList\":[{\"logicType\":\"AND\",\"queryObjectList\":[{\"fieldId\":\"contact_phone\",\"filterType\":\"EQ\",\"value\":\"18000000000\"},{\"fieldId\":\"contact_related_customer\",\"filterType\":\"EQ\",\"value\":\"INST-XXX\"}]}]}", "current_operator_userid":"user01", "provider_corpid":"dingxxx", "page_size":"100" }'

{ "errcode": 0, "errmsg": "ok", "result": { "values": [ { "gmt_create": "2019-12-25 15:33:12", "instance_id": "INST_XX", "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\"}", "object_type": "crm_contact", "creator_userid": "user01", "permission": [ { "participant_userid_list": [ "user01", "user02" ], "owner_userid_list": [ "user01", "user02" ] } ], "gmt_modified": "2019-12-25 15:33:12", } ], "next_cursor": "100", "has_more": true, "page_size": 100 } }

请求参数

Query 参数

access_token

必需

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

示例值:

dc73axxxx

Body 参数application/json

current_operator_userid

string

用户userid。

可选

cursor

string

分页游标。

可选

page_size

number

分页大小。

必需

provider_corpid

string

可选

服务商组织ID。自建应用可以传入。

query_dsl

string

查询条件。

可选

示例

返回响应

🟢200成功

application/json

Body

result

object

分页结果。

必需

next_cursor

string

下一页的游标。

必需

values

array [object {8}]

数据列表。

必需

has_more

boolean

是否有下一页。

必需

page_size

integer

分页大小。

必需

errcode

integer

必需

errmsg

string

返回码描述。

必需

根据指定条件查询联系人数据

权限#

请求参数

返回响应

权限