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

news2024/9/21 15:45:49

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

第三期介绍：频道模块之频道成员

目录

  • QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第三期]
    • 第三期介绍：频道模块之频道成员
      • 获取子频道在线成员数
      • 获取频道成员列表
      • 获取频道身份组成员列表
      • 获取频道成员详情
      • 删除频道成员
      • 致谢和更新

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

在这里插入图片描述

获取子频道在线成员数

接口
GET /channels/{channel_id}/online_nums

功能描述
此接口用于查询音视频/直播子频道channel_id的在线成员数。

Content-Type
application/json

返回
成功时返回空对象，包含在线成员数：

{
  "online_nums": 1
}

错误码
具体错误码信息请参考错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/channels/{channel_id}/online_nums"
Authorization = f"QQBot {你的鉴权，不懂得看前面文章}"

herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()

print(response)

运行成功如下，因为我没有音频子频道，所以是如下输出：

{'code': 505007, 'message': 'requested channel is not audio or live channel'}

在这里插入图片描述

获取频道成员列表

接口
GET /guilds/{guild_id}/members

功能描述
用于获取指定guild_id的频道中所有成员的详情列表，支持分页。

注意事项

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

Content-Type
application/json

参数

字段名类型描述
afterstring上一次回包中最后一个 member 的 user id，如果是第一次请求填 0，默认为 0
limituint32分页大小，1-400，默认是 1。成员较多的频道尽量使用较大的 limit 值，以减少请求数

返回
返回Member对象数组。

返回结果说明

  1. 在每次翻页的过程中，可能会返回上一次请求已经返回过的member信息，需要调用方自己根据user id来进行去重。
  2. 每次返回的member数量与limit不一定完全相等。翻页请使用最后一个member的user id作为下一次请求的after参数，直到回包为空，拉取结束。

错误码
具体错误码信息请参考错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/members?limit=2"
Authorization = f"QQBot {你的鉴权}"

herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()

print(response)

运行结果如下：

# 运行出来的是一行的，不好展示，使用官方回复样式，实际获取数据和这个大差不差
[
  {
    "user": {
      "id": "xxxxxx",
      "username": "xxxx",
      "avatar": "xxxxxx",
      "bot": false,
      "public_flags": 0,
      "system": false,
      "union_openid": "xxxxxx",
      "union_user_account": ""
    },
    "nick": "",
    "roles": ["1"],
    "joined_at": "2021-12-09T15:53:41+08:00",
    "deaf": false,
    "mute": false,
    "pending": false
  },
  {
    "user": {
      "id": "xxxxxx",
      "username": "秦时明月",
      "avatar": "xxxxxx",
      "bot": false,
      "public_flags": 0,
      "system": false,
      "union_openid": "xxxxxx",
      "union_user_account": ""
    },
    "nick": "",
    "roles": ["4"],
    "joined_at": "2021-12-02T15:19:00+08:00",
    "deaf": false,
    "mute": false,
    "pending": false
  }
]

在这里插入图片描述

获取频道身份组成员列表

接口
GET /guilds/{guild_id}/roles/{role_id}/members

功能描述
用于获取 guild_id 频道中指定 role_id 身份组下所有成员的详情列表，支持分页。

注意

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

参数

字段名类型描述
start_indexstring将上一次回包中 next 填入，如果是第一次请求填 0，默认为 0
limituint32分页大小，1-400，默认是 1。成员较多的频道尽量使用较大的 limit 值，以减少请求数

返回

字段名类型描述
dataMember 对象数组一组用户信息对象
nextstring下一次请求的分页标识

有关返回结果的说明
每次返回的 member 数量与 limit 不一定完全相等。特定管理身份组下的成员可能存在一次性返回全部的情况。

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/roles/{role_id}/members?limit=2"
Authorization = f"QQBot {你的鉴权}"

herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()

print(response)

运行结果如下：

{
  "data": [
    {
      "user": {
        "id": "xxx",
        "username": "xxx",
        "avatar": "xxx",
        "bot": false
      },
      "nick": "xxx",
      "joined_at": "2021-11-03T20:41:36+08:00"
    }
  ],
  "next": "0"
}

在这里插入图片描述

获取频道成员详情

接口
GET /guilds/{guild_id}/members/{user_id}

功能描述
用于获取 guild_id 指定的频道中 user_id 对应成员的详细信息。

Content-Type
application/json

返回
返回 Member 成员对象。

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/members/{user_id}"
Authorization = f"QQBot {你的鉴权}"

herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()

print(response)

运行结果如下：

{
  "user": {
    "id": "2823701233424295228",
    "username": "xxx",
    "avatar": "https://qqchannel-profile-1251316161.file.myqcloud.com/xxxxxxx",
    "bot": false,
    "union_openid": "",
    "union_user_account": ""
  },
  "nick": "",
  "roles": [
    "1"
  ],
  "joined_at": "2021-12-05T14:08:29+08:00"
}

在这里插入图片描述

删除频道成员

接口
DELETE /guilds/{guild_id}/members/{user_id}

功能描述
用于删除 guild_id 指定的频道下的成员 user_id。

  1. 需要使用的 token 对应的用户具备踢人权限。如果是机器人，要求被添加为管理员。(读者需要知道的是，在我们提交的鉴权里，除了机器人的，也可以提交管理员的鉴权，当你提交的是机器人的鉴权，那么将是机器人执行，如果你提交的是操作者的鉴权，那么将是操作者执行，这在第一期提过一点)
  2. 操作成功后，会触发 频道成员删除事件。
  3. 无法移除身份为管理员的成员

注意

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

Content-Type
application/json

参数

字段名类型描述
add_blacklistbool删除成员的同时，将该用户添加到频道黑名单中
delete_history_msg_daysint删除成员的同时，撤回该成员的消息，可以指定撤回消息的时间范围

注：消息撤回时间范围仅支持固定的天数： 3， 7， 15， 30。 特殊的时间范围： -1: 撤回全部消息。默认值为 0 不撤回任何消息。

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

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/members/{user_id}"
Authorization = f"QQBot {你的鉴权}"

data = {
    {
    "add_blacklist": True,# 删除成员的同时，将该用户添加到频道黑名单中
    "delete_history_msg_days": -1# -1: 撤回全部消息
}
}
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.delete(url, headers=herders).json()

print(response)

我懒得删除自己的用户，这里返回就不展示了，官方也没有给示例，成功了就是返回状态码。
在这里插入图片描述

致谢和更新

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

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

在这里插入图片描述
⬅️QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]
➡️第四期：频道模块之频道身份组与权限管理(更新中…)

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2120731.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

计算机组成原理简介

计算机组成原理简介

计算机组成原理简介 计算机组成原理是一门研究计算机系统结构、工作原理及其性能分析的学科。它主要探讨计算机硬件的结构及其与软件的交互，旨在帮助我们理解计算机如何执行任务、处理数据和控制指令流。 本文将从以下几个方面介绍计算机组成原理的基本概念&#…
阅读更多...
大和解！淘宝微信11年“屏蔽战”终落幕

大和解！淘宝微信11年“屏蔽战”终落幕

​转载：新熵 原创 作者丨余寐 编辑丨蕨影 拆墙之后，一切才刚刚开始。 见证历史的时刻到了！互联网两大巨头正式牵手，淘宝平台拟全面引入微信支付。 淘宝天猫方面回应称，淘宝天猫始终秉持开放的合作理念，积…
阅读更多...
【FPGA数字信号处理】- FIR串行滤波器

【FPGA数字信号处理】- FIR串行滤波器

理解和掌握 FIR 串行滤波器是踏入数字信号处理领域的重要一步。 那么，什么是 FIR 串行滤波器？它是如何工作的？又有着怎样的神奇之处呢？让我们一起揭开它的神秘面纱。 一、FIR 滤波器简介 FIR 滤波器，全称为有限脉冲…
阅读更多...
GMT绘图笔记：绘制堆叠三维图

GMT绘图笔记：绘制堆叠三维图

绘制三维图可以更好地表现物理场的空间分布和对比，也有很多的软件工具可以实现这一功能，本专栏主要强调使用GMT绘制。语法也非常简单，实例代码如下： gmt begin tibet_moho_3D png,pdf E600 # 绘制底图 gmt set FORMAT_GEO_MAP d…
阅读更多...
【超快解决方法】教资点击打印准考证没反应！！！

【超快解决方法】教资点击打印准考证没反应！！！

首先点击右键【检查】 2.选中控制台 3.点击小红点 4.再点击第二个链接就可以下载下来啦
阅读更多...
【Delphi】实现程序屏幕内容防止截图

【Delphi】实现程序屏幕内容防止截图

前言： 有时候，我们做的程序界面内容不希望被截图，那么如何实现呢？其实实现起来非常简单，就是一句话的事。 在主窗口show的时候，调用如下参数即可！需要注意的是Delphi中并没有定义WDA_EXCLUDEFRO…
阅读更多...
微信加粉计数器/微信加人计数网页版

微信加粉计数器/微信加人计数网页版

微信加粉计数器/微信加人计数网页版 计数器支持的vx版本微信计数器特色计数器的定制开发 计数器支持的vx版本 最新版本计数器支持任意版本的微信，在也不用使用指定的版本了 微信计数器特色 目前该计数器采用非hook,非注入，不修改覆盖任何源文件 计数…
阅读更多...
Dagger：Android 和 Java 的快速依赖注入框架

Dagger：Android 和 Java 的快速依赖注入框架

在软件开发中，依赖注入（DI）是一种设计模式，用于实现控制反转，减少代码耦合，提高模块化。Dagger 是一个由 Google 开发的依赖注入库，专门用于 Android 和 Java 应用程序，以其快速和高…
阅读更多...
为什么 GitHub 成为开发者的“唯一真爱”？吊打其他代码托管平台

为什么 GitHub 成为开发者的“唯一真爱”？吊打其他代码托管平台

GitHub，这个名字可能已经深深印在了每一个开发者的脑海里。但你有没有想过，为什么 GitHub 能够在激烈的竞争中脱颖而出，成为全球最大、最流行的代码托管平台？其实它的成功背后，有着很多不为人知的细节。今天我们就来聊聊 GitHub 是如何一步步赢得开发者的心，让其他竞争对…
阅读更多...
何时何地，你需要提示工程、函数调用、RAG还是微调大模型？

何时何地，你需要提示工程、函数调用、RAG还是微调大模型？

介绍 在快速发展的生成式人工智能领域，某些流行术语已变得司空见惯：“提示工程”、“函数调用”、“RAG”和“微调”，你应该也经常遇到这些术语，但你是否能够理清这些概念之间的关系？这些其实都是一些大模型的应用策略…
阅读更多...
OpenGL Texture C++ 预览Camera视频

OpenGL Texture C++ 预览Camera视频

OpenGL是一个图形API，并不是一个独立的平台。包含了一系列可以操作图形、图像的函数。基于Texture纹理强大的功能，本篇文章实现Android OpenGL Texture C 预览Camera视频流的功能。 项目github地址：https://github.com/wangyongyao1989/WyFFm…
阅读更多...
Reflection Llama-3.1 70B:目前最强大的开源大语言模型

Reflection Llama-3.1 70B:目前最强大的开源大语言模型

Reflection Llama-3.1 70B:目前最强大的开源大语言模型 模型特点性能表现使用建议未来展望 近日,一个名为Reflection Llama-3.1 70B的新型大语言模型(LLM)引起了业界广泛关注。该模型采用了名为"Reflection-Tuning"的创新训练技术,能够自主检测推理过程中的错误并及时…
阅读更多...
入门必看！高薪+自由职业的3D建模师有多香？

入门必看！高薪+自由职业的3D建模师有多香？

‌3D建模‌是将现实世界中的物体或场景转化为三维数字模型的过程。这项技术连接着现实与虚拟两个世界，通过3D建模，我们可以将名胜古迹、雕塑艺术品等以三维的形式呈现于互联网，让用户体验到更加真实、立体的视觉感受。3D建模的应用领域广泛&a…
阅读更多...
【基于 Spring Boot 的二手交易平台】

【基于 Spring Boot 的二手交易平台】

构建一个基于 Spring Boot 的二手交易平台是一个涉及多个组件和技术栈的复杂项目。以下是一个基本的框架概述，可以帮助你开始搭建这样一个平台： 技术栈选择 Spring Boot: 用于快速开发 RESTful Web 服务。数据库: MySQL, PostgreSQL, 或其他关系型数据…
阅读更多...
华为 HCIP-Datacom H12-821 题库 (15)

华为 HCIP-Datacom H12-821 题库 (15)

有需要题库的可以加下方Q群 V群进行学习交流 1.以下关于 OSPF 路由聚合的描述，错误的是哪一项？ A、OSPF 中任意一台路由器都可以进行路由聚合的操作 B、OSPF 有两种路由聚合方式：ABR 聚合和ASBR 聚合 C、路由聚合是指将相同前缀的路由信息聚合…
阅读更多...
018.PL-SQL编程—包

018.PL-SQL编程—包

我 的 个 人 主 页：👉👉 失心疯的个人主页 👈👈 入 门 教 程 推 荐 ：👉👉 Python零基础入门教程合集 👈👈 虚 拟 环 境 搭 建 ：👉&…
阅读更多...
【Prompt Engineering提示：Active-Prompt、方向性刺激提示、PAL（程序辅助语言模型）】

【Prompt Engineering提示：Active-Prompt、方向性刺激提示、PAL（程序辅助语言模型）】

Active-Prompt 思维链（CoT）方法依赖于一组固定的人工注释范例。问题在于，这些范例可能不是不同任务的最有效示例。为了解决这个问题，Diao 等人（2023）(opens in a new tab)最近提出了一种新的提示方法&…
阅读更多...
Python的情感词典情感分析和情绪计算

Python的情感词典情感分析和情绪计算

一.大连理工中文情感词典 情感分析 (Sentiment Analysis)和情绪分类 (Emotion Classification）都是非常重要的文本挖掘手段。情感分析的基本流程如下图所示，通常包括： 自定义爬虫抓取文本信息；使用Jieba工具进行中文分词、词性标…
阅读更多...
015.PL-SQL编程—块

015.PL-SQL编程—块

我 的 个 人 主 页：👉👉 失心疯的个人主页 👈👈 入 门 教 程 推 荐 ：👉👉 Python零基础入门教程合集 👈👈 虚 拟 环 境 搭 建 ：👉&…
阅读更多...
Python专项进阶——初步认识Numpy库

Python专项进阶——初步认识Numpy库

NumPy是Numeric Python的缩写，一个优秀的开源科学计算库。 个人理解，NumPy是一个主要围绕着数值数组对象（ndarray）（或叫做矩阵）进行各种操作的对象、函数集合。提供很多实用的数学函数，涵盖线性…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023