dingtalk.oapi.crm.objectdata.contact.create (钉钉PaaS主数据-创建CRM联系人数据)

CRM主数据,创建联系人数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
instance ObjectDataInstanceVo 必须 联系人数据
  • └ creator_userid
  • String
  • 必须
  • ding_userid
  • 记录创建人的用户ID
  • └ creator_nick
  • String
  • 可选
  • 张三
  • 记录创建人的昵称
  • └ data
  • 必须
  • {"contact_name":"李四"}
  • 数据内容
  • └ extend_data
  • 可选
  • {}
  • 扩展数据内容
  • permission
  • DataPermissionVo
  • 可选
  • 权限
  • └ participant_userids
  • String []
  • 可选
  • ["123,456"]
  • 协同人的用户ID
  • └ owner_userids
  • String []
  • 可选
  • ["123,456"]
  • 负责人的用户ID
provider_corpid String 可选 dingxx 自建应用时可选服务商组织ID

响应参数

名称 类型 示例值 描述
success Boolean true 执行结果
errcode Number 0 错误码
errmsg String OK 错误信息
result ObjectDataCreateDto 结果
  • └ instance_id
  • String
  • instance_id
  • 联系人数据id
  • └ contact_unionid
  • String
  • ding_unionid
  • 联系人用户ID
  • └ contact_userid
  • String
  • ding_userid
  • 联系人通讯录员工ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/crm/objectdata/contact/create");
OapiCrmObjectdataContactCreateRequest req = new OapiCrmObjectdataContactCreateRequest();
ObjectDataInstanceVo obj1 = new ObjectDataInstanceVo();
obj1.setCreatorUserid("ding_userid");
obj1.setCreatorNick("张三");
DataPermissionVo obj2 = new DataPermissionVo();
obj2.setParticipantUserids(""123,456"");
obj2.setOwnerUserids(""123,456"");
obj1.setPermission(obj2);
req.setInstance(obj1);
req.setProviderCorpid("dingxx");
OapiCrmObjectdataContactCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "success":true,
    "errcode":0,
    "errmsg":"OK",
    "result":{
        "instance_id":"instance_id",
        "contact_unionid":"ding_unionid",
        "contact_userid":"ding_userid"
    }
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部