# 修改机器人别名

[异步回调]修改机器人别名

限制条件:

当企业管理员在管理员后台,【我的企业】-【通讯录管理】-【成员可修改字段】不包含该信息时,则机器人无法修改别名。

请求方式:POST

请求地址:https://$basehost/gateway/qopen/ModifyRobotAlias

body参数

{
    "robot_id": "机器人id",
    "alias": "新的别名"
}
字段 类型 必填 说明
robot_id string 机器人id
alias string 新的别名

返回值:

{
    "data": {
        "serial_no": ""
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
   serial_no string 请求序列号
hint string 请求日志ID

处理结果,异步返回值:

{
    "event_type": 100001,
    "serial_no": "操作序列号",
    "err_code": 0,
    "err_msg": "success",
    "robot_id": "机器人id",
    "data": {
        "alias": "新的别名"
    }
}

说明

字段 类型 说明
event_type int 事件类型,100001
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
data.alias string 别名

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/ModifyRobotAlias \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
          "robot_id": "机器人id",
          "alias": "新的别名"
}'
最后更新时间: 2023/5/24 10:48:59