首页 > 其他分享 >QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第三期]

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

时间：2024-09-10 09:53:31浏览次数：9  
标签：QQ 频道 机器人 json 详解 user id Authorization

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

标签：QQ,频道,机器人,json,详解,user,id,Authorization
From： https://blog.csdn.net/qq_71745595/article/details/142070682

相关文章

  • Linux Makefile文件名处理函数知识详解
    GNUmake提供了一系列对文件名进行各种操作的函数：文件名替换、加前缀、去目录等。1.1dir函数：取路径名的目录dir函数用来从一个路径名中截取目录的部分。$(dirNAMES…)dir函数会从NAMES文件名序列中，取出各个文件路径名中的目录部分并返回.PHONY:allLIST=/home/wit/ban......
  • MySQL timestamp和datetime用法详解
    一、MySQL中如何表示当前时间？其实，表达方式还是蛮多的，汇总如下：CURRENT_TIMESTAMPCURRENT_TIMESTAMP()NOW()LOCALTIMELOCALTIME()LOCALTIMESTAMPLOCALTIMESTAMP() 二、关于TIMESTAMP和DATETIME的比较一个完整的日期格式如下：YYYY-MM-DDHH:MM:SS[.fraction]，它可分为两部......
  • 【Java 分支语句详解 之 If 】
    Java分支语句详解之If-else在编程过程中，我们经常需要根据不同的条件执行不同的代码块，这种流程控制被称为分支语句。在Java中，常见的分支控制结构有if-else和switch。本文将详细介绍if分支结构的使用方法以及相关的代码示例。一、单分支控制语句(if)基本语......
  • 构建基于Qwen API 的AgentScope 聊天机器人
    环境搭建与库安装首先，我们需要创建一个Python3.10环境。你可以使用conda来创建一个新的虚拟环境，并激活它：condacreate-npy310python==3.10condaactivatepy310接着，安装所需的库agentscope，由于它可能处于预发布阶段，因此我们需要指定--pre标志：pipinstallagentscope--pre获取......
  • 零基础用python开发btc（二bitcoinlib详解）
    bitcoinlib是一个用于Python的比特币库，支持比特币和其他加密货币的生成、交易和管理。以下是如何在Windows、macOS或Linux上安装和使用bitcoinlib的详细教程。1.安装Python首先，确保你安装了Python3.x，并且已配置了pip（Python的包管理工具）。可以在终端中运行以下......
  • 解锁Python中的人脸识别：Face Recognition库详解与应用
    在当今的人工智能时代，人脸识别技术已经成为了计算机视觉领域的一项重要应用。无论是在安全监控、社交媒体还是智能设备中，人脸识别都扮演着不可或缺的角色。在众多的人脸识别工具和库中，Python的FaceRecognition库以其简单易用和高效性而备受青睐。本文将深入探讨FaceRecogniti......
  • 微信小程序开发系列5----页面配置--WXML列表渲染-wxkey详解
        下图本来选中Switch1更新后选中的是Switch5了  使用下图红色部分就能解决，id是data里定义的换name也可以，红色部分不能写item.Id 注：不给wx:key会给一个警告，给了性能会更高 源码获取方式（免费）：（1）登录-注册：http://resources.kittytiger.cn/（2）签到获取积分（3）搜索......
  • Web安全之CSRF攻击详解与防护
    在互联网应用中，安全性问题是开发者必须时刻关注的核心内容之一。跨站请求伪造（Cross-SiteRequestForgery,CSRF），是一种常见的Web安全漏洞。通过CSRF攻击，黑客可以冒用受害者的身份，发送恶意请求，执行诸如转账、订单提交等操作，导致严重的安全后果。本文将详细讲解CSRF攻击的原......
  • Vue.js 组件设计详解
    在现代Web开发中，组件化设计已经成为构建可维护和可扩展应用程序的关键策略之一。而Vue.js作为一个流行的前端框架，以其简单易用、灵活和高效的特点，成为开发者的首选之一。本文将详细介绍如何设计Vue组件，涵盖从基础到高级的概念和实践，包括组件的创建、通信、复用、优化和......
  • 栈迁移（详解）
    栈迁移原理栈迁移主要利用了leave_ret这个指令leave返回上级函数时，恢复原本的栈空间leavemovesp,ebppopebpret返回上级函数后，执行上级函数的命令ret等同于popeip(不存在这样的指令esp'''ebpret在函数的先执行到leave指令时，会将ebp处填充的地址pop到ebp中去......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99