功能说明：根据contactsId获取对应的联系人详情信息
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/crm/contacts/getContactsDetail.do?token=token&corpId=corpId
参数：data
{
"contactsId": "9662f5e997914a9ea0e81751b5feac47"
}
| 参数 | 说明 | 类型 | 是否必填 |
备注 |
|---|---|---|---|---|
| contactsId | 联系人Id | String | 是 |
|
// 创建请求参数
CrmContactsDetailReqVO vo = new CrmContactsDetailReqVO();
// 设置获取类型
vo.setContactsId("9662f5e997914a9ea0e81751b5feac47");
System.out.println(JSONUtil.stringify(vo));
CrmApi api = QwSdkUtil.getInter(CrmApi.class);
// 调用接口
ApiCrmContactsDetailsResultVO contactsInfo = api.getContactsDetail(QwSdkUtil.getCacheToken(), vo);
System.out.println(JSONUtil.stringify(contactsInfo));
{
"code":"0",
"data":
{
"contactsInfo":
{
"birthday":"2019-12-04",
"chargePerson":
[
{
"userId":"3ds5c67f34b68ae590ccaadcbf49c0ad",
"userName":"张三"
},
{
"userId":"3bfcfds384f33d51ddc3c39bc5571bf8",
"userName":"李四"
}
],
"clientId":"bf6af4f7-1a7d-468c-bb66-cf3f18a28869",
"clientName":"客户名称",
"contactsName":"姓名",
"createTime":"2019-12-04 16:14:11",
"creator":"test12",
"customFields":
[
{
"fieldName":"单行",
"fieldType":"TextField",
"fieldValue":"单行"
},
{
"fieldName":"多行",
"fieldType":"TextArea",
"fieldValue":"多行\n多行\n多行\n多行"
},
{
"fieldName":"下拉",
"fieldType":"SelectField",
"fieldValue":"2222"
},
{
"fieldName":"联系方式",
"fieldType":"PhoneNumber",
"fieldValue":"1234567810"
},
{
"fieldName":"整数",
"fieldType":"Integer",
"fieldValue":"20"
},
{
"fieldName":"小数",
"fieldType":"Double",
"fieldValue":"22"
},
{
"fieldName":"百分比",
"fieldType":"Percent"
},
{
"fieldName":"undef..",
"fieldType":"Percent"
}
],
"email":"wxyqhs@qq.com",
"hobby":"兴趣爱好",
"mobile":"12345678910",
"position":"职位",
"relativePerson":
[
{
"userId":"b2583781abe120249e653c5bb4fcc9df",
"userName":"chenrong"
},
{
"userId":"b7f63854a54dab923b3b1b9cb677d1fc",
"userName":"cxb"
}
],
"remark":"备注\n",
"schoolName":"毕业院校",
"seniorFields":
[
{
"fieldName":"（表单）单行文字",
"fieldType":"TextField",
"fieldValue":"（表单）单行文字"
},
{
"fieldName":"（表单）邮箱",
"fieldType":"EmailField",
"fieldValue":"baidu@163.com"
},
{
"fieldName":"（表单）数字",
"fieldType":"NumberField",
"fieldValue":"17"
},
{
"fieldName":"（表单）电话",
"fieldType":"TelephoneField",
"fieldValue":"13212345679"
},
{
"fieldName":"（表单）手机",
"fieldType":"MobileField",
"fieldValue":"13212345688"
},
{
"fieldName":"（表单）多行文字",
"fieldType":"TextArea",
"fieldValue":"（表单）多行文字\n（表单）多行文字\n（表单）多行文字"
},
{
"fieldName":"（表单）日期",
"fieldType":"DateField",
"fieldValue":"2019-12-04"
},
{
"fieldName":"（表单）时间",
"fieldType":"TimeField",
"fieldValue":"16:01"
},
{
"fieldName":"（表单）日期时间",
"fieldType":"DateTimeField",
"fieldValue":"2019-12-04 16:01"
},
{
"fieldName":"（表单）单项选择",
"fieldType":"RadioButton",
"fieldValue":"选项2"
},
{
"fieldName":"（表单）多项选择",
"fieldType":"CheckBox",
"fieldValue":
[
"选项1",
"选项3"
]
},
{
"fieldName":"（表单）下拉框",
"fieldType":"DropDown",
"fieldValue":"选项2"
},
{
"fieldName":"（表单）评分",
"fieldType":"RatingField",
"fieldValue":"3"
},
{
"fieldName":"（表单）地理位置",
"fieldType":"GeoField"
},
{
"fieldName":"（表单）说明项",
"fieldType":"ImageCheckBox"
},
{
"fieldName":"（表单）分节",
"fieldType":"SectionBreak"
},
{
"fieldName":"（表单）图片",
"fieldType":"ImageField",
"fieldValue":
[
{
"fileExt":"JPEG",
"fileName":"test12_20191204160143178_364.JPEG",
"fileSizeStr":"22.21 K",
"id":"fo03a32cded98b45f0802326e78a3422aa",
"url":"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20191204/b565131ef6364b68b5202b7e3a2ea596.jpeg"
}
]
},
{
"fieldName":"（表单）省市区",
"fieldType":"CityField",
"fieldValue":"北京市:北京市:西城区"
},
{
"fieldName":"（表单）计算式",
"fieldType":"EquationField",
"fieldValue":"17"
},
{
"fieldName":"（表单）两级下拉框",
"fieldType":"CascadeDropDown",
"fieldValue":"选项1:二级选项1"
},
{
"fieldName":"（表单）微信扫码",
"fieldType":"ImageRadioButton"
},
{
"fieldName":"（表单）流水号",
"fieldType":"SerialNumberField",
"fieldValue":"0003"
},
{
"fieldName":"（表单）手写签名",
"fieldType":"HandWrittenField"
},
{
"fieldName":"（表单）通讯录成员",
"fieldType":"MEMBERCustomerField",
"fieldValue":
[
{
"deptFullName":"开发小组1",
"deptId":"8f68dfcc400dcbcea2c02b92de29fc4",
"headPic":"http://shp.qpic.cn/bizmp/ck4hSGq23RjMhicqucxwgwOb1n45wJCODzsLL87zrDAwBEAFia3Fb2yg/100",
"mobile":"13212345678",
"orgId":"df3-292e-4cc9-ac5d-0b46bce059c4",
"personName":"张三",
"userId":"dsdd67f34b68ae590ccaadcbf49c0ad",
"userNo":"001",
"wxUserId":"zhangsan"
},
{
"deptFullName":"开发小组2",
"deptId":"2c81deb6288576399ff52671b9fbb875",
"headPic":"http://shp.qpic.cn/bizmp/ck4hSGq23RgbOh6S2MzkhGNyJTLmqHgMNCib3bJqiaZXeK7fZ9LhGTtQ/100",
"mobile":"13412345678",
"orgId":"df3-292e-4cc9-ac5d-0b46bce059c4",
"personName":"李四",
"userId":"dfsddf33d51ddc3c39bc5571bf8",
"userNo":"002",
"wxUserId":"lisi"
}
]
},
{
"fieldName":"（表单）部门",
"fieldType":"DEPTCustomerField",
"fieldValue":
[
{
"departmentName":"部门1",
"id":"1251fc59231faf44bd47fb68c834704"
},
{
"departmentName":"部门2",
"id":"fdsc47932215f1019856bc4d55ade80f"
},
{
"departmentName":"部门3",
"id":"67fdb35fc3ddb7bfefe41440411dbe16"
}
]
}
],
"telephone":"12345678911",
"updateTime":"2019-12-04 16:14:11"
}
},
"desc":"成功"
}
contactsInfo参数
| 参数 | 说明 | 备注 |
|---|---|---|
contactsName
|
联系人名字
|
|
clientId
|
所属客户id |
|
clientName
|
所属客户名称
|
|
position
|
职位
|
|
mobile
|
手机号码
|
|
telephone
|
座机号码
|
|
email
|
邮箱
|
|
|
birthday
|
生日
|
|
schoolName
|
毕业院校
|
|
|
hobby
|
兴趣爱好
|
|
|
remark
|
备注
|
|
chargePerson
|
负责人 |
|
|
relativePerson
|
相关负责人人 |
|
creator
|
创建人
|
|
createTime
|
创建时间
|
|
updateTime
|
更新时间
|
|
|
customFields
|
自定义字段 |
|
|
seniorFields |
表单字段 |
|
负责/相关人参数（包括chargePerson、relativePerson）
| 参数 | 说明 | 备注 |
|---|---|---|
| id | 联系人负责/相关人ID |
|
| name | 联系人负责/相关人名字 |
|
customField参数
| 参数 | 说明 | 备注 |
|---|---|---|
|
fieldName |
自定义字段名 |
|
| fieldType | 自定义字段类型 |
TextField：单行；TextArea：多行；SelectField：下拉选项；DateTime：日期； Integer：整数；Double：小数；Percent：百分数；PhoneNumber：电话号码 |
| fieldValue | 自定义字段值 |
|
seniorFields参数
|
参数 |
说明 | 备注 |
|---|---|---|
|
fieldName |
字段名称 |
|
|
fieldType |
字段类型 |
TextField(单行文字)、EmailField(邮箱)、NumberField(数字)、TelephoneField(电话)、MobileField(手机)、 ImageRadioButton(微信扫码)、SerialNumberField(流水号)、HandWrittenField(手写签名)、MEMBERCustomerField(通讯录成员)、 DEPTCustomerField(部门) |
|
fieldValue |
字段值 |
(1) 如果是图片类型，则是一个图片对象，包括fileName（文件名）、fileSizeStr（文件大小）、id（文件id）、fileExt（文件类型）、url（文件地址）； (2) 如果是通讯录类型，则是一个通讯录用户对象，包括personName（用户名）、wxUserId（用户微信id）、userNo（用户编号）、deptId（部门id）、 mobile（联系方式）、departmentNo（部门编号）、headPic（头像地址）、userId（用户id）、orgId（机构id）、deptFullName（部门全称）； (3) 如果是部门类型，则是一个部门对象，包括departmentName（部门名称）、id（部门id）； |