Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
新版服务端API(DingTalk OpenAPI)
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
  1. 客户管理
  • 获取服务窗联系人信息
    GET
  • 添加CRM个人客户
    POST
  • 更新CRM个人客户
    PUT
  • 根据指定条件批量获取客户数据
    GET
  • 删除CRM个人客户
    DELETE
  • 批量获取CRM个人客户
    POST
  • 获取CRM客户对象的元数据
    GET
  • CRM获取全量客户数据
    POST
  • 释放客户
    POST
  1. 客户管理

批量获取CRM个人客户

POST
http://127.0.0.1/v1.0/crm/personalCustomers/batchQuery
新版服务端API(DingTalk OpenAPI)/客户管理
最后修改时间:2022-08-30 09:19:21
责任人:未设置

说明#

调用本接口批量获取CRM个人客户。
服务地址:api.dingtalk.com

权限#

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

错误码#

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

请求参数

Query 参数
currentOperatorUserId
string 
可选
操作人的用户userid。
Header 参数
x-acs-dingtalk-access-token
string 
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
array[string]
必需
数据客户instanceId列表。
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/v1.0/crm/personalCustomers/batchQuery' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
result
array [object {14}] 
返回结果。
可选
orgId
integer 
企业ID。
可选
instanceId
string 
可选
客户数据实例instanceId。
objectType
string 
数据类型。
可选
creatorUserId
string 
可选
创建人的用户userid。
creatorNick
string 
创建人的昵称。
可选
data
object 
数据内容。
可选
extendData
object 
扩展数据内容。
可选
permission
object 
数据权限信息。
可选
appUuid
string 
可选
应用appUuid。
formCode
string 
可选
表单formCode。
procOutResult
string 
审批结果。
可选
procInstStatus
string 
审批状态。
可选
gmtCreate
string 
创建时间。
可选
gmtModified
string 
修改时间。
可选
示例
{
  "result": [
    {
      "orgId": 0,
      "instanceId": "string",
      "objectType": "string",
      "creatorUserId": "string",
      "creatorNick": "string",
      "data": {},
      "extendData": {},
      "permission": {
        "ownerStaffIds": [
          "string"
        ],
        "participantStaffIds": [
          "string"
        ]
      },
      "appUuid": "string",
      "formCode": "string",
      "procOutResult": "string",
      "procInstStatus": "string",
      "gmtCreate": "string",
      "gmtModified": "string"
    }
  ]
}
上一页
删除CRM个人客户
下一页
获取CRM客户对象的元数据
Built with