修改坐席接口

1.接口简介

用于修改指定坐席的相关信息。如果用手机方式接听拨打电话,可以不用登录系统用该接口绑定手机号

2.接口请求

  • HTTP请求方式:POST

  • 请求链接:{HOST}/v20160818/user/updateUser/{ACCOUNTID}?sig={sig}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名,{ACCOUNTID}替换为账户编号,{SIG}是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则

  • 请求频次限制:10次/分钟

  • 鉴权文档:接口鉴权

3.接口参数如下:

字段 类型 是否必须 备注
exten String 坐席号,一般为8000,8001,8002等
displayName String 坐席姓名(需要修改时传此参数,传新值)
email String 邮箱(需要修改时传此参数,传新值)
password String 登录密码(需要修改时传此参数,传新值)
mobile String 手机号(需要修改时传此参数,传新值)
department String 部门(需要修改时传此参数,传新值)

注意:坐席姓名和坐席手机号不能重复

请求体示例

{
    "exten":"8000",
    "displayName":"新名字",
    "email":"xxx@xxx.com",
    "department":"YF"
}

4.系统返回

字段 含义
code 响应码
message 响应信息

code:

代码 含义
200 请求成功
210 坐席不存在
400 请求体参数错误
403 鉴权参数错误
500 服务器错误

返回200示例

{
    "code": 200,
    "message": "ok"
}

返回210示例:

{
    "code": 210,
    "message": "user not found"
}

返回400示例:

{
    "code": 400,
    "message": "Please check your parameters"
}

返回403示例:

{
    "code": 403,
    "message": "Forbidden"
}

返回500示例:

{
    "code": 500,
    "message": "Internal Server Error"
}