Bot API
2026/1/3大约 1 分钟
此目录下为云湖官网bot机器人文档
提示
这里收集了一些由于API请求格式不规范等导致错误的响应,欢迎补充
(请求头:服务器会区分大小写)
群聊中未添加机器人
{
"code": -1,
"msg": "群(ID:xxx)中未添加当前机器人(ID: xxxxxxxx)。"
}不存在/chat-id错误
{
"code": -1,
"msg": "群(ID:xxx)不存在。"
}chat-type错误
群聊:
{
"code": 1002,
"msg": "chat-type取值错误,取值仅支持group、user"
}用户:
{
"code": 1002,
"msg": "recvType取值错误,取值仅支持group、user"
}token错误
{
"code": 1003,
"msg": "非法token"
}缺少chat-id
{
"code": 1002,
"msg": "chat-id值错误,值不能为空"
}token不存在
{
"code": 1002,
"msg": "token不存在"
}请求json错误
第一种:
{
"code": 1002,
"msg": "请求参数应为json格式,Body内容为: {}" // {}是请求json内容
}第二种:
{
"code": 1002,
"msg": "请求参数应为json格式"
}用户未添加机器人
{
"code": 1003,
"msg": "recvId值错误,该用户不是机器人好友"
}contentType错误
{
"code": 1002,
"msg": "contentType取值错误,请翻看文档"
}消息为空
{
"code": 1002,
"msg": "消息内容不能为空"
}msgId错误/无权修改
{
"code": -1,
"msg": "消息不存在或无权限修改"
}媒体上传失败
图片:
{
"code": -1,
"msg": "图片获取失败"
}视频:
{
"code": -1,
"msg": "视频获取失败"
}文件:
{
"code": -1,
"msg": "文件获取失败"
}看板content内容为空
{
"code": 1002,
"msg": "看板内容不能为空"
}