根据指定条件批量获取客户数据

说明

调用本接口根据指定查询条件批量获取CRM个人客户。
服务地址：api.dingtalk.com

权限

要调用此API，需要以下权限之一。

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

错误码

HttpCode	错误码	错误信息	说明
400	systemError.appNotExists	system error, app not exists, %s	应用不存在
400	systemError.notPermittedAccess	system error, not permitted access, %s	无权限操作
500	systemError	system error %s	系统错误

请求参数

Query 参数

currentOperatorUserId

string

用户userid。

可选

nextToken

string

分页页码。

可选

maxResults

string

分页条数。

必需

queryDsl

string

查询条件。

可选

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

values

array [object {11}]

返回结果。

可选

instanceId

string

数据ID。

可选

objectType

string

数据类型

可选

creatorUserId

string

可选

创建记录的用户userid。

creatorNick

string

可选

创建记录的用户昵称。

data

object

数据内容。

可选

extendData

object

扩展数据内容。

可选

permission

object

数据权限信息。

可选

procOutResult

string

审批结果。

可选

procInstStatus

string

审批状态。

可选

gmtCreate

string

记录创建时间。

可选

gmtModified

string

记录修改时间。

可选

hasMore

boolean

是否有下一页。

可选

nextToken

string

分页游标。

可选

maxResults

integer

分页大小。

可选

示例

{
  "values": [
    {
      "instanceId": "string",
      "objectType": "string",
      "creatorUserId": "string",
      "creatorNick": "string",
      "data": {},
      "extendData": {},
      "permission": {
        "ownerStaffIds": [
          "string"
        ],
        "participantStaffIds": [
          "string"
        ]
      },
      "procOutResult": "string",
      "procInstStatus": "string",
      "gmtCreate": "string",
      "gmtModified": "string"
    }
  ],
  "hasMore": true,
  "nextToken": "string",
  "maxResults": 0
}

根据指定条件批量获取客户数据

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码