QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]

news/2024/11/15 0:43:02/

QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]

第二期介绍：频道模块之频道管理

目录

  • QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]
    • 第二期介绍：频道模块之频道管理
      • 获取用户详情
      • 获取用户频道列表
      • 获取频道详情
      • 获取子频道列表
      • 获取子频道详情
      • 创建子频道
      • 修改子频道
      • 删除子频道
      • 致谢和更新

不懂得的也可以来私聊或评论区问哦～
在这里插入图片描述
原力到一千才可以推广，三连啊喂！！！

在这里插入图片描述

获取用户详情

接口

GET /users/@me

功能描述
用于获取当前用户（机器人）详情。

Content-Type

application/json

返回
返回 User 对象。

错误码
详见错误码。

Python示例

# 用于获取当前用户（机器人）详情。
import requestsurl = "https://api.sgroup.qq.com/users/@me"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.get(url, headers=herders)print(response.json())

获取的数据包如下：

{"id": "11586990140073229091","username": "gitsub","avatar": "https://thirdqq.qlogo.cn/g?b=oidb&k=M5TibpXicS7Jt4z89BZxiamAA&s=100&t=1641802698","union_openid": "74F138F7F3AF68C4B8E8325013FCA295","union_user_account": ""
}

在这里插入图片描述

获取用户频道列表

接口

GET /users/@me/guilds

功能描述
用于获取当前用户（机器人）所加入的频道列表，支持分页。

当 HTTP Authorization 中填入 Bot Token 是获取机器人的数据，填入 Bearer Token 则获取用户的数据。

总的来说就是

Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"

你要获取机器人数据，格式为QQBot {这个内容填写第一期我们获取的调用凭证}，如果获取用户数据，格式为Bearer 调用凭证

Content-Type

application/json

返回
返回 Guild 对象数组。

错误码
详见错误码。

Python示例

import requests"""
用于获取当前用户（机器人）所加入的频道列表，支持分页。当 HTTP Authorization 中填入 Bot Token 是获取机器人的数据，填入 Bearer Token 则获取用户的数据。
"""url = "https://api.sgroup.qq.com/users/@me/guilds"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
headers = {"Content-Type": "application/json","Authorization": Authorization
}response = requests.get(url, headers=headers).json()
print(response)

获取的数据包如下：

[{"id": "696527283900292399","name": "鹅们的萌宠啦咔咔啦","icon": "https://groupprohead-76292.picgzc.qpic.cn/482231626508223/100?t=1626508224633","owner_id": "4828365788198541698","owner": false,"joined_at": "2021-12-08T16:12:31+08:00","member_count": 17,"max_members": 300,"description": "123"
}]

🧐这里需要注意，当你有多个频道时，你获取的数据包格式为：

[{你第一个频道的数据},{你第二个频道的数据},{...}]

当你想要获取其中某一个值时，例如 id 的值，可以使用：

response[0]['id']

在这里插入图片描述

获取频道详情

接口

GET /guilds/{guild_id}

🧐在获取频道列表的数据包后，数据包内包含了频道的 guild_id

功能描述
用于获取 guild_id 指定的频道的详情。

Content-Type

application/json

返回
返回 Guild 对象

错误码
详见错误码。

Python示例

import requests
"""
用于获取 guild_id 指定的频道的详情。
"""
url = f"https://api.sgroup.qq.com/guilds/{guild_id}"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.get(url, headers=herders).json()
print(response)

获取的数据包如下：

{"id": "123456","name": "xxxxxx","icon": "xxxxxx","owner_id": "xxxxxx","owner": false,"joined_at": "2022-01-13T11:02:21+08:00","member_count": 5,"max_members": 300,"description": "千江有水千江月，万里无云万里天"
}

在这里插入图片描述

获取子频道列表

接口

GET /guilds/{guild_id}/channels

🧐在获取频道列表的数据包后，数据包内包含了频道的 guild_id

功能描述
用于获取 guild_id 指定的频道下的子频道列表。

Content-Type

application/json

返回
返回 Channel 对象数组。

错误码
详见错误码。

Python示例

import requestsurl = f"https://api.sgroup.qq.com/guilds/{guild_id}/channels"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.get(url, headers=herders).json()
print(response)

获取的数据包如下：

[{"id": "xxxxxx","guild_id": "123456","name": "很高兴遇见你","type": 4,"position": 2,"parent_id": "0","owner_id": "0","sub_type": 0},{"id": "xxxxxx","guild_id": "123456","name": "🔒管理员议事厅","type": 0,"position": 1,"parent_id": "xxxxxx","owner_id": "0","sub_type": 0,"private_type": 1},{"id": "xxxxxx","guild_id": "123456","name": "🚪小黑屋","type": 0,"position": 2,"parent_id": "xxxxxx","owner_id": "0","sub_type": 0,"private_type": 0},{"id": "xxxxxx","guild_id": "123456","name": "新的子频道","type": 0,"position": 2,"parent_id": "123456","owner_id": "0","sub_type": 0,"private_type": 2}
]

🧐这里需要注意，当你有多个子频道时，你获取的数据包格式为：

[{你第一个频道的数据},{你第二个频道的数据},{...}]

当你想要获取其中某一个值时，例如 id 的值，可以使用：

response[0]['id']

在这里插入图片描述

获取子频道详情

接口

GET /channels/{channel_id}

🧐在获取子频道列表的数据包后，数据包内包含了频道的 channel_id

功能描述
用于获取 channel_id 指定的子频道的详情。

Content-Type

application/json

返回
返回 Channel 对象。

错误码
详见错误码。

Python示例

import requestsurl = f"https://api.sgroup.qq.com/channels/{channel_id}"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.get(url, headers=herders).json()
print(response)

获取的数据包如下：

{"id": "123456","guild_id": "xxxxxx","name": "很高兴遇见你","type": 4,"position": 2,"owner_id": "0","sub_type": 0,"private_type": 0,"speak_permission": 0,"application_id": "0"
}

在这里插入图片描述

创建子频道

接口

POST /guilds/{guild_id}/channels

功能描述
用于在 guild_id 指定的频道下创建一个子频道。

  • 要求操作人具有管理频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 创建成功后，返回创建成功的子频道对象，同时会触发一个频道创建的事件通知。

注意
公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

参数

字段名类型描述
namestring子频道名称
typeint子频道类型 ChannelType
sub_typeint子频道子类型 ChannelSubType
positionint子频道排序，必填；当子频道类型为 子频道分组（ChannelType=4） 时，必须大于等于 2
parent_idstring子频道所属分组ID
private_typeint子频道私密类型 PrivateType
private_user_idsstring 数组子频道私密类型成员 ID
speak_permissionint子频道发言权限 SpeakPermission
application_idstring应用类型子频道应用 AppID，仅应用子频道需要该字段

返回
返回 Channel 对象。

错误码
详见错误码。

Python示例

import requestsurl = f"https://api.sgroup.qq.com/guilds/{guild_id}/channels"
Authorization = f"QQBot {你自己的鉴权}"data = {"name": "测试频道1",# 名字随意"type": 0,# 文字子频道"position": 1,"parent_id": "xxx","owner_id": "xxx","sub_type": 0,"private_type": 0
}herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.post(url, headers=herders, json=data).json()
print(response)

获取的数据包如下：

{"id": "xxxxxx","guild_id": "xxxxxx","name": "测试频道1","type": 0,"position": 1,"parent_id": "xxxxx","owner_id": "xxxxxx","sub_type": 0
}

在这里插入图片描述

修改子频道

接口

PATCH /channels/{channel_id}

🧐在获取子频道列表的数据包后，数据包内包含了频道的 channel_id

功能描述
用于修改 channel_id 指定的子频道的信息。

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 修改成功后，会触发子频道更新事件。

注意
公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

参数

字段名类型描述
namestring子频道名
positionint排序
parent_idstring分组 id
private_typeint子频道私密类型 PrivateType
speak_permissionint子频道发言权限 SpeakPermission

🤗需要修改哪个字段，就传递哪个字段即可。

返回
返回 Channel 对象。

错误码
详见错误码。

Python示例

import requestschannel_id = "xxx"
url = f"https://api.sgroup.qq.com/channels/{channel_id}"
Authorization = f"QQBot xxx"data = {"name": "测试频道2",
}herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.patch(url, headers=herders, json=data).json()
print(response)

获取的数据包如下：

{"id": "xxxxxx","guild_id": "xxxxxx","name": "测试频道2","type": 0,"position": 1,"parent_id": "xxxxx","owner_id": "xxxxxx","sub_type": 0
}

在这里插入图片描述

删除子频道

接口

DELETE /channels/{channel_id}

🧐在获取子频道列表的数据包后，数据包内包含了频道的 channel_id

功能描述
用于删除 channel_id 指定的子频道。

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 修改成功后，会触发子频道删除事件。

注意
公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

返回
成功返回 HTTP 状态码 200。

错误码
详见错误码。

Python示例

import requestschannel_id = "xxx"
url = f"https://api.sgroup.qq.com/channels/{channel_id}"
Authorization = f"QQBot xxx"herders = {"Content-Type": "application/json","Authorization": Authorization}response = requests.delete(url, headers=herders, json=data).json()
print(response)

注意
子频道的删除是无法撤回的，一旦删除，将无法恢复。
在这里插入图片描述

致谢和更新

文章持续更新，如果三连支持，速更！！！
请在评论区提出疑惑和建议
上次更新: 9/8/2024, PM

👻关于频道和子频道事件，它们基于websocket方法。因为目前在讲openapi方法调用QQ频道机器人，所以暂时跳过这部分，当然放心啦，三连我速更，肯定会讲啦。

在这里插入图片描述
文章内容都是连续的，如果你在本文没有找到解决办法，不如前往其他几期寻找答案吧😉

⬅️QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第一期]

➡️QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第三期]


http://www.ppmy.cn/news/1523899.html

相关文章

个人随想-一道简单的AI面试题

个人随想-一道简单的AI面试题

大模型的兴起，很多公司现在都开始进入AI开发的新篇章，那么或多或少​也需要招聘一些AI的开发人员。 其实很多公司需要的，说白了就是一个AI开发工程师或者架构师，但是在招聘过程中，或多或少对要求写的太过夸张&#xf…
阅读更多...
膨胀腐蚀操作opencv dilate膨胀白膨胀，erode腐蚀是黑吃白。主要针对二值图

膨胀腐蚀操作opencv dilate膨胀白膨胀，erode腐蚀是黑吃白。主要针对二值图

效果： 代码： import cv2 import numpy as np from matplotlib import pyplot as pltif __name__ "__main__":h 10w 10data np.random.normal(0, 1, [h, w]) # sigma, 2*sigma, 3*sigma之间的数的比例分别为0.68， 0.96&#…
阅读更多...
什么是设计模式，要掌握那些知识

什么是设计模式，要掌握那些知识

设计模式就像是软件开发中的“秘籍”，它们是经过无数开发者反复实践验证的“套路”，帮助我们解决常见的代码设计问题。如果把编程比作武功，那设计模式就像是“武功秘籍”，能让你在应对复杂开发问题时，招式更灵活、思路…
阅读更多...
Ubuntu 24.04 配置 nginx + php-fpm

Ubuntu 24.04 配置 nginx + php-fpm

nginx 是一个流行的 web 服务器，以其速度和可靠性而闻名，被许多顶级网站使用。要用 PHP 运行网站，您需要设置 php-fpm，nginx 与 php-fpm 一起处理 PHP 文件并将其显示给用户，帮助网站更快地加载并处理更多流量。 本教…
阅读更多...
每日一题——第八十五题

每日一题——第八十五题

题目&#xff1a;写一个函数&#xff0c;输入一个十六进制/八进制数/二进制数,输出对应的十进制数 #include<stdio.h> #include<stdlib.h> #include<string.h> #include<ctype.h> long stringToDecimal(const char* str, int base);int main() {char …
阅读更多...
ML 系列：机器学习和深度学习的深层次总结（02）线性回归

ML 系列：机器学习和深度学习的深层次总结（02）线性回归

ML 系列&#xff1a; — 简单线性回归 线性回归、损失函数、假设函数 图 1.线性回归 文章目录 一、说明二、线性回归2.1 简单线性回归2.2 回归中的损失函数 三、线性回归中的评估标准四、线性回归模型训练五、可视化5.1 假设函数5.2 计算训练模型的损失&#xff1a;5.3 绘制 H…
阅读更多...
Spring Cloud Gateway学习记录

Spring Cloud Gateway学习记录

Spring中文网 https://springdoc.cn/spring-cloud-gateway/ Spring官网 https://spring.io/projects/spring-cloud-gateway 网关简介 大家都都知道在微服务架构中&#xff0c;一个系统会被拆分为很多个微服务。那么作为客户端要如何去调用这么多的微服务呢&#xff1f; 如果…
阅读更多...
某red书最新版x-s、x-s-common（上）

某red书最新版x-s、x-s-common（上）

目标&#xff1a;达人主页笔记翻页接口 打上xhr断点 断住后回溯堆栈&#xff0c;会发现直到异步堆栈为止参数都是已经生成的&#xff0c;那么进入异步堆栈打上断点 刷新页面发现参数已经生成&#xff0c;那么继续往下找堆栈 进入第二个异步。发现此时参数并未生成 异步调试…
阅读更多...
最新文章

Copyright @ 2022~2023