# 发布群公告

[异步回调] 发布群公告

请求方式:POST

请求地址:https://api.aquanliang.com/gateway/qopen/PublishGroupNotice

body参数

{
    "robot_id": "机器人id",
    "group_id": "群id",
    "group_notice": "公告内容",
    "mark_id": "透传id,若传参将会覆盖系统生成的serial_no,贯穿整个业务流程"
}
字段 类型 必填 说明
robot_id string 机器人id
group_id string 群id
group_notice string 公告内容
mark_id string 透传id,若传参将会覆盖系统生成的serial_no,贯穿整个业务流程

返回值:

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

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
serial_no string 操作序列号,系统生成,与回调中的serial_no一致

处理结果,异步返回值 encoding_content解密后的结构:

{
    "event_type": 40021,
    "serial_no": "操作序列号",
    "err_code": 0,
    "err_msg": "success",
    "data":{
    	"robot_id": "机器人id",
    	"group_id": "群id",
    	"group_name": "群名",
    	"group_notice": " "
    }
}

说明

字段 类型 说明
event_type int 事件类型,40021
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
group_id string 群id
group_name string 群名
group_notice string 群公告

完整请求示例:

curl -X POST \
  https://api.aquanliang.com/gateway/qopen/PublishGroupNotice \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
        "robot_id": "机器人id",
        "group_id": "群id",
        "group_notice": "公告内容"
      }'