# 机器人扫码入群(平台号)
[异步回调] 机器人扫码入群
请求方式:POST
请求地址:https://$basehost/gateway/qopen/JoinGroupByScanQRCode
body参数:
{
"robot_id": "机器人id",
"group_qr_code": "群聊二维码",
"group_qr_code_base64":"群聊二维码base64值"
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
group_qr_code | string | 是 | 群聊二维码 |
group_qr_code_base64 | string | 是 | 群聊二维码base64值,如果group_qr_code,group_qr_code_base64都传,默认使用group_qr_code |
返回值:
{
"data": {
"serial_no": "操作序列号"
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
serial_no | string | 请求序列号 |
hint | string | 请求日志ID |
处理结果,异步返回值:
{
"event_type": 300018,
"serial_no": "操作序列号",
"err_code": 0,
"err_msg": "success",
"robot_id": "机器人id",
"data": {
"group_id" : "成功入群的群编号",
"group_qr_code": "群聊二维码",
"group_type": 1
}
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,300018 |
serial_no | string | 操作序列号 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
robot_id | string | 机器人id |
data | object | 返回数据 |
data.group_id | string | 成功入群的群编号 |
data.group_qr_code | string | 群聊二维码 |
data.group_type | int | 群聊类型:0外部群,1内部群(扫码号暂无无法获取该字段) |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/JoinGroupByScanQRCode \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"group_qr_code": "xx",
"group_qr_code_base64":"xxx"
}'
← 修改机器人工作签名 机器人通过好友入群邀请 →