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客户对象的元数据

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

说明#

调用本接口获取CRM客户对象的元数据描述。
服务地址:api.dingtalk.com

权限#

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

错误码#

HttpCode错误码错误信息说明
400invalidParaminvalid param, %s参数非法
400systemError.notPermittedAccesssystem error, %s无权限操作
500systemErrorsystem error系统错误
500systemErrorsystem error, %s系统错误

请求参数

Header 参数
x-acs-dingtalk-access-token
string 
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}

示例代码

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

返回响应

🟢200成功
application/json
Body
name
string 
对象名称。
可选
customized
boolean 
是否自定义对象。
可选
fields
array [object {12}] 
字段列表。
可选
name
string 
字段名称。
可选
customized
boolean 
是否自定义字段。
可选
label
string 
字段展示名。
可选
type
string 
字段类型。
可选
nillable
boolean 
是否可空。
可选
format
string 
日期格式。
可选
unit
string 
可选
日期单位或金额单位。
selectOptions
array [object {2}] 
选项列表。
可选
quote
boolean 
是否引用关联。
可选
referenceTo
string 
关联对象名称。
可选
referenceFields
array [object {7}] 
可选
引用的关联对象的字段列表。
rollUpSummaryFields
array [object {2}] 
可选
对MasterDetail类型有效。
示例
{
  "name": "string",
  "customized": true,
  "fields": [
    {
      "name": "string",
      "customized": true,
      "label": "string",
      "type": "string",
      "nillable": true,
      "format": "string",
      "unit": "string",
      "selectOptions": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "quote": true,
      "referenceTo": "string",
      "referenceFields": [
        {
          "label": "string",
          "type": "string",
          "nillable": true,
          "unit": "string",
          "format": "string",
          "selectOptions": [
            {
              "key": "string",
              "value": "string"
            }
          ],
          "name": "string"
        }
      ],
      "rollUpSummaryFields": [
        {
          "name": "string",
          "aggregator": "string"
        }
      ]
    }
  ]
}
上一页
批量获取CRM个人客户
下一页
CRM获取全量客户数据
Built with