网站自动识别手机代码,上海百度竞价点击软件,个人网站做捐赠发布违法吗,wordpress 调用浏览数QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第五期]
第五期介绍#xff1a;频道模块之接口授权管理和发言管理 目录 QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第五期]第五期介绍#xff1a;频道模块之接口授权管理和发言管理获取机器人在频道可用权限列表…QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第五期]
第五期介绍频道模块之接口授权管理和发言管理 目录 QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第五期]第五期介绍频道模块之接口授权管理和发言管理获取机器人在频道可用权限列表发送机器人在频道接口权限的授权链接获取频道消息频率的设置详情频道全员禁言频道指定成员禁言频道批量成员禁言致谢和更新 不懂得的也可以来私聊或评论区问哦 原力到一千才可以推广三连啊喂 获取机器人在频道可用权限列表
接口
GET /guilds/{guild_id}/api_permission功能描述 用于获取机器人在频道 guild_id 内可以使用的权限列表。
Content-Type application/json
返回
字段名类型描述apisAPIPermission 对象数组机器人可用权限列表
错误码 详见错误码。
Python示例
import requestsguild_id 你的频道ID
url fhttps://api.sgroup.qq.com/guilds/{guild_id}/api_permission
Authorization QQBot 你的鉴权tokenheaders {Authorization: Authorization
}response requests.get(url, headersheaders).json()print(response)响应数据包
# 取决于你给了机器人多少权限我都给了数据包返回了一大堆数据
{apis: [{path: /guilds/{guild_id}/members/{user_id},method: GET,desc: 获取当前频道成员信息,auth_status: 0},{path: /channels/{channel_id}/messages,method: POST,desc: 创建消息,auth_status: 1}]
}发送机器人在频道接口权限的授权链接
接口
POST /guilds/{guild_id}/api_permission/demand功能描述 用于创建 API 接口权限授权链接该链接指向 guild_id 对应的频道。
每天只能在一个频道内发 3 条默认值频道权限授权链接。
Content-Type application/json
参数
字段名类型描述channel_idstring授权链接发送的子频道 idapi_identifyAPIPermissionDemandIdentify 对象api 权限需求标识对象descstring机器人申请对应的 API 接口权限后可以使用功能的描述
返回 返回 APIPermissionDemand 对象。
错误码 详见错误码。
Python示例
import requestsguild_id 你的频道ID
url fhttps://api.sgroup.qq.com/guilds/{guild_id}/api_permission/demand
Authorization fQQBot 你的鉴权tokendata {channel_id: 你的子频道id,api_identify: {path: /guilds/{guild_id},method: GET},desc: 显示频道信息
}headers {Content-Type: application/json,Authorization: Authorization
}response requests.post(url, headersheaders, jsondata).json()print(response)请求数据包
{channel_id: 123456,api_identify: {path: /guilds/{guild_id},method: GET},desc: 显示频道信息
}响应数据包
{guild_id: xxxxxx,channel_id: 123456,api_identify: {path: /guilds/{guild_id},method: GET},title: 王者机器人申请授权频道信息接口权限,desc: 申请权限后才能正常使用机器人显示频道信息功能
}示例图 获取频道消息频率的设置详情
接口
GET /guilds/{guild_id}/message/setting功能描述 用于获取机器人在频道 guild_id 内的消息频率设置。
Content-Type application/json
返回 返回 MessageSetting 对象。
错误码 详见错误码。
Python示例
import requestsguild_id 你的频道ID
url fhttps://api.sgroup.qq.com/guilds/{guild_id}/message/setting
Authorization fQQBot 你的鉴权tokenheaders {Authorization: Authorization
}response requests.get(url, headersheaders).json()print(response)响应数据包
{disable_create_dm: true, # 是否允许创建私信disable_push_msg: false, # 是否允许发主动消息channel_ids: [1146313,2651849,2651149],# 子频道 id 数组channel_push_max_num: 12 # 每个子频道允许主动推送消息最大消息条数
}频道全员禁言
接口
PATCH /guilds/{guild_id}/mute功能描述 用于将频道的全体成员非管理员禁言。
需要使用的 token 对应的用户具备管理员权限。如果是机器人要求被添加为管理员。
该接口同样可用于解除禁言具体使用见 解除全员禁言。
Content-Type application/json
参数
字段名类型描述mute_end_timestampstring禁言到期时间戳绝对时间戳单位秒与 mute_seconds 字段同时赋值的话以该字段为准mute_secondsstring禁言多少秒两个字段二选一默认以 mute_end_timestamp 为准
解除禁言 该接口同样支持解除全员禁言将mute_end_timestamp或mute_seconds传值为字符串’0’即可。
返回 成功返回 HTTP 状态码 204。
错误码 详见错误码。
Python示例
import requestsguild_id 你的频道ID
url fhttps://api.sgroup.qq.com/guilds/{guild_id}/mute
Authorization fQQBot 你的鉴权token# mute_end_timestamp和mute_seconds设置一个就好了时间戳别用案例里面的自己设置。
data {mute_end_timestamp: 1641916800,mute_seconds: 120
}headers {Authorization: Authorization
}response requests.patch(url, headersheaders, jsondata)if response.status_code 204:print(全员禁言成功)
else:print(禁言失败状态码, response.status_code)请求数据包
{mute_end_timestamp: xxxx,mute_seconds: 120
}示例图 频道指定成员禁言
接口
PATCH /guilds/{guild_id}/members/{user_id}/mute功能描述 用于禁言频道 guild_id 下的成员 user_id。
需要使用的 token 对应的用户具备管理员权限。如果是机器人要求被添加为管理员。
该接口同样可用于解除禁言具体使用见 解除指定成员禁言。
Content-Type application/json
参数
字段名类型描述mute_end_timestampstring禁言到期时间戳绝对时间戳单位秒与 mute_seconds 字段同时赋值的话以该字段为准mute_secondsstring禁言多少秒两个字段二选一默认以 mute_end_timestamp 为准
返回 成功返回 HTTP 状态码 204。
错误码 详见错误码。
Python示例
import requestsguild_id 你的频道ID
user_id 你的用户ID
url fhttps://api.sgroup.qq.com/guilds/{guild_id}/members/{user_id}/mute
Authorization fQQBot 你的鉴权tokendata {mute_end_timestamp: 1641916800,mute_seconds: 120
}headers {Authorization: Authorization
}response requests.patch(url, headersheaders, jsondata)if response.status_code 204:print(指定成员禁言成功)
else:print(禁言失败状态码, response.status_code)请求数据包
{mute_end_timestamp: 1641916800,mute_seconds: 120
}频道批量成员禁言
接口
PATCH /guilds/{guild_id}/mute功能描述 用于将频道的指定批量成员非管理员禁言。
需要使用的 token 对应的用户具备管理员权限。如果是机器人要求被添加为管理员。
该接口同样可用于批量解除禁言具体使用见 批量解除禁言。
Content-Type application/json
参数
字段名类型描述mute_end_timestampstring禁言到期时间戳绝对时间戳单位秒与 mute_seconds 字段同时赋值的话以该字段为准mute_secondsstring禁言多少秒两个字段二选一默认以 mute_end_timestamp 为准user_idsstring列表禁言成员的user_id列表即 User 的id
批量解除禁言 该接口同样支持批量解除禁言将mute_end_timestamp或mute_seconds传值为字符串’0’即可及需要批量解除禁言的成员的user_id 列表user_ids。
返回 成功返回 HTTP 状态码 200并返回设置成功的成员 user_ids。
错误码 详见错误码。
Python示例
import requestsguild_id 你的频道ID
url fhttps://api.sgroup.qq.com/guilds/{guild_id}/mute
Authorization fQQBot 你的鉴权tokendata {mute_end_timestamp: 1641916800,mute_seconds: 120,user_ids: [1201318637970874066,1201318637970874067]
}headers {Authorization: Authorization
}response requests.patch(url, headersheaders, jsondata)if response.status_code 200:print(批量成员禁言成功)print(response.json())
else:print(禁言失败状态码, response.status_code)请求数据包
{mute_end_timestamp: 1641916800,mute_seconds: 120,user_ids: [1201318637970874066,1201318637970874067]
}响应数据包
{user_ids: [1201318637970874066]
}致谢和更新
文章持续更新如果三连支持速更 请在评论区提出疑惑和建议 上次更新: 9/12/2024, AM ⬅️第四期频道模块之频道身份组与权限管理 ➡️第六期频道模块之内容管理
