客户资料

调用本接口新增或编辑客户资料。

权限

要调用此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/customers' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "datatype" : Long, "stamp" : Long, "msgid" : Long, "data" : { "data_userid" : "String", "kh_pkhid" : "String", "kh_class" : "String", "kh_name" : "String", "kh_sex" : "String", "kh_shortname" : "String", "kh_industry" : "String", "kh_employees" : "String", "kh_address" : "String", "kh_country" : "String", "kh_province" : "String", "kh_city" : "String", "kh_coaddress" : "String", "kh_hottype" : "String", "kh_hotlevel" : "String", "kh_hotfl" : "String", "kh_hotmemo" : "String", "kh_type" : "String", "kh_status" : "String", "kh_sn" : "String", "kh_handset" : "String", "kh_email" : "String", "kh_dingtalk" : "String", "kh_tel" : "String", "kh_weixin" : "String", "kh_qq" : "String", "kh_skype" : "String", "kh_wangwang" : "String", "kh_worktel" : "String", "kh_fax" : "String", "kh_pst" : "String", "kh_department" : "String", "kh_appellation" : "String", "kh_preside" : "String", "kh_headship" : "String", "kh_web" : "String", "kh_befontof" : "String", "kh_from" : "String", "kh_billinfo" : "String", "kh_info" : "String", "kh_ralagrade" : "String", "kh_creditgrade" : "String", "kh_valrating" : "String", "kh_cttype" : "String", "kh_ctnumber" : "String", "kh_contype" : "String", "kh_remark" : "String", "kh_jibie" : "String" } }'

请求参数

Header 参数

x-acs-dingtalk-access-token

必需

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

Body 参数application/json

datatype

integer

必需

数据类型，固定值148。

stamp

integer

时间戳，单位：秒。

必需

msgid

integer

可选

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

data

object

编辑数据。

可选

data_userid

string

创建人。

必需

kh_pkhid

string

上级客户。

可选

kh_class

string

类别，取值。

必需

kh_name

string

客户名称。

必需

kh_sex

string

性别，取值。

可选

kh_shortname

string

助记简称。

可选

kh_industry

string

行业。

可选

kh_employees

string

人员规模。

可选

kh_address

string

家庭地址。

可选

kh_country

string

国家地区。

可选

kh_province

string

省份。

可选

kh_city

string

城市。

可选

kh_coaddress

string

单位地址。

可选

kh_hottype

string

是否为热点客。

可选

kh_hotlevel

string

热度，取值。

可选

kh_hotfl

string

热点分类。

可选

kh_hotmemo

string

热点说明。

可选

kh_type

string

种类。

可选

kh_status

string

阶段。

可选

kh_sn

string

编号。

可选

kh_handset

string

手机号。

可选

kh_email

string

邮箱。

可选

kh_dingtalk

string

钉钉号。

可选

kh_tel

string

家庭电话。

可选

kh_weixin

string

微信号。

可选

kh_qq

string

QQ号。

可选

kh_skype

string

Skype账号。

可选

kh_wangwang

string

旺旺。

可选

kh_worktel

string

工作电话。

可选

kh_fax

string

传真。

可选

kh_pst

string

邮编。

可选

kh_department

string

部门。

可选

kh_appellation

string

称谓。

可选

kh_preside

string

负责业务。

可选

kh_headship

string

职务。

可选

kh_web

string

网址。

可选

kh_befontof

string

爱好。

可选

kh_from

string

来源。

可选

kh_billinfo

string

开票资料。

可选

kh_info

string

公司简介。

可选

kh_ralagrade

string

关系等级。

可选

kh_creditgrade

string

信用等级，取值。

可选

kh_valrating

string

价值评估，取值。

可选

kh_cttype

string

证件类型。

可选

kh_ctnumber

string

证件号码。

可选

kh_contype

string

联系人分类

可选

kh_remark

string

备注。

可选

kh_jibie

string

客户级别。

可选

示例

权限#

错误码#

请求参数

返回响应

权限

错误码