联系人

调用本接口新增或编辑联系人

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	金智CRM数据管理权限	API Explorer
第三方企业应用	支持	金智CRM数据管理权限	API Explorer
第三方个人应用	暂不支持	金智CRM数据管理权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	saveFail	保存数据发生错误	保存数据发生错误
400	invalidRequestMethod	请求方式错误，必须为post请求！	请求方式错误，必须为post请求！
400	invalidParameter	请求参数缺失或无效！	请求参数缺失或无效！
400	invalidSeCretKey	无效的SeCretKey	无效的SeCretKey
400	invalidSign	签名无效	签名无效

curl --location --request POST 'https://api.dingtalk.com/v1.0/jzcrm/contacts' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "datatype" : 197, "stamp" : 1621822122, "msgid" : 1, "data" : { "data_userid" : "张三", "lxr_customerid" : "客户1", "lxr_name" : "李四", "lxr_handset" : "169896989698", "lxr_worktel" : "3688-898899", "lxr_sex" : "男", "lxr_group" : "部门总监", "lxr_preside" : "管理", "lxr_cttype" : "身份证", "lxr_ctnumber" : "369898569856985", "lxr_chengwei" : "总监", "lxr_type" : "联系人", "lxr_department" : "市场部", "lxr_headship" : "市场部总监", "lxr_dingtalk" : "钉钉号", "lxr_fax" : "传真", "lxr_wangwang" : "旺旺", "lxr_email" : "56898998@qq.com", "lxr_weixin" : "wx_567435t4", "lxr_qq" : "89698896", "lxr_tel" : "3622-986568", "lxr_pst" : "698659", "lxr_skype" : "skype", "lxr_address" : "四川省成都市", "lxr_birthday" : "1991-6-9", "lxr_like" : "游泳", "lxr_remark" : "备注", "lxr_photo" : "名片" } }'

请求参数

Header 参数

x-acs-dingtalk-access-token

必需

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

Body 参数application/json

datatype

integer

必需

数据类型，固定值197。

stamp

integer

时间戳。

必需

msgid

integer

可选

数据ID。
值为0或不填时，为新增数据。

data

object

编辑数据。

可选

data_userid

string

创建人。

必需

lxr_customerid

string

对应客户。

必需

lxr_name

string

姓名。

必需

lxr_handset

string

手机。

可选

lxr_worktel

string

工作电话。

可选

lxr_sex

string

性别，取值。

可选

lxr_group

string

分类。

可选

lxr_preside

string

负责业务。

可选

lxr_cttype

string

证件类型。

可选

lxr_ctnumber

string

证件号码。

可选

lxr_chengwei

string

称谓。

可选

lxr_type

string

类型，取值。

可选

lxr_department

string

部门。

可选

lxr_headship

string

职务。

可选

lxr_dingtalk

string

钉钉号。

可选

lxr_fax

string

传真。

可选

lxr_wangwang

string

旺旺。

可选

lxr_email

string

邮箱。

可选

lxr_weixin

string

微信号

可选

lxr_qq

string

QQ号。

可选

lxr_tel

string

家庭电话。

可选

lxr_pst

string

邮编。

可选

lxr_skype

string

Skype账号。

可选

lxr_address

string

住址。

可选

lxr_birthday

string

生日。

可选

lxr_like

string

爱好。

可选

lxr_remark

string

备注。

可选

lxr_photo

string

联系名片。

可选

示例

权限#

错误码#

请求参数

返回响应

权限

错误码