3.1 批量添加通讯录
简要描述:
- 批量添加通讯录,此功能为增量导入,一次最大导入量为500
- 导出增加失败列表,返回失败原因,失败的联系人也添加到数据中
- 号码唯一,导入的号码如果已经在通讯录中存在,则按照新导入的信息(包括组信息)更新之前的联系人
请求URL:
请求方式:
- POST
参数:
|
参数名 |
类型 |
必选项 |
说明 |
|
userId |
int |
是 |
用户 userId,目前必须是应用管家的超级管理员 |
|
addressList |
arrayList |
是 |
通讯录参会人列表,不能为空,数量最大500 |
参数:addressList
|
参数名 |
类型 |
必选 |
说明 |
|
depName |
String |
是 |
部门信息,通讯录完整部门,递进用“/”隔开,比如:“全时公司/研发部门/电话会议组” |
|
contactName |
String |
是 |
姓名 |
|
contactEmail |
String |
否 |
手机参会人邮箱 |
|
contactPhone |
String |
是 |
手机号码 |
|
contactCountry |
String |
是 |
国家码,格式如“86”,长度不能超出8位,首位不能为0 |
|
contactAreaCode |
String |
否 |
国内区号(手机号码无区号),长度不能超出8位 |
返回参数说明:
|
参数名 |
类型 |
说明 |
|
code |
Int |
状态值 |
|
msg |
String |
错误描述 |
| requestId | String | 请求id |
|
data |
Json |
返回导入的结果 |
返回data参数说明:
|
参数名 |
类型 |
说明 |
|
successNum |
int |
成功导入的数量 |
|
failedNum |
int | 失败的数量 |
| failedList | arrayList | 失败列表 |
参数:failedList
|
参数名 |
类型 |
说明 |
|
depName |
String |
部门信息 |
|
contactName |
String |
姓名 |
|
contactEmail |
String |
手机参会人邮箱 |
|
contactPhone |
String |
手机号码 |
|
contactCountry |
String |
国家码 |
|
contactAreaCode |
String |
国内区号(手机号码无区号) |
| remarks | String |
错误信息,导入错误有以下几种: 1、部门未填写 2、姓名未填写 3、电话或者邮箱未填写,二者不能同时为空 4、国家码格式不正确(必须是数字,不能以0开头,长度不能超过8位) 5、区号格式不正确(必须是数字,长度不能超过8位) 6、电话格式不正确(必须是数字) 7、区号未填写(非中国手机号码,区号不能为空) 8、邮箱格式不正确 |
传参示例
{
"userId":6135684,
"addressList": [{
"depName":"部门",
"contactName": "张三",
"contactEmail": "",
"contactPhone": "13771855601",
"contactCountry": "86",
"contactAreaCode": ""
}
]
}
|
返回示例
{
"code":0,
"msg":"Address Create Succeeded",
"requestId" : "7bf63bab-5a00-fd0d-9d23-5cd102932b5a",
"data":{
"successNum":"10",
"failed":"0",
"failedList":[]
}
}
|


