@alemonjs/qq-bot 2.1.0-alpha.9 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -45
- package/lib/config.d.ts +8 -0
- package/lib/config.js +20 -0
- package/lib/desktop.d.ts +1 -3
- package/lib/desktop.js +3 -12
- package/lib/hook.d.ts +36 -9
- package/lib/hook.js +21 -19
- package/lib/index.d.ts +5 -7
- package/lib/index.js +11 -21
- package/lib/index.webhook.d.ts +1 -0
- package/lib/index.webhook.js +5 -4
- package/lib/index.websoket.d.ts +1 -0
- package/lib/index.websoket.js +31 -23
- package/lib/message/AT_MESSAGE_CREATE.d.ts +35 -0
- package/lib/message/AT_MESSAGE_CREATE.js +1 -0
- package/lib/message/CHANNEL_CREATE.d.ts +15 -0
- package/lib/message/CHANNEL_CREATE.js +1 -0
- package/lib/message/CHANNEL_DELETE.d.ts +15 -0
- package/lib/message/CHANNEL_DELETE.js +1 -0
- package/lib/message/CHANNEL_UPDATE.d.ts +15 -0
- package/lib/message/CHANNEL_UPDATE.js +1 -0
- package/lib/message/DIRECT_MESSAGE_CREATE.d.ts +29 -0
- package/lib/message/DIRECT_MESSAGE_CREATE.js +1 -0
- package/lib/message/DIRECT_MESSAGE_DELETE.d.ts +17 -0
- package/lib/message/DIRECT_MESSAGE_DELETE.js +1 -0
- package/lib/message/ERROR.d.ts +1 -0
- package/lib/message/ERROR.js +1 -0
- package/lib/message/GUILD_CREATE.d.ts +15 -0
- package/lib/message/GUILD_CREATE.js +1 -0
- package/lib/message/GUILD_DELETE.d.ts +15 -0
- package/lib/message/GUILD_DELETE.js +1 -0
- package/lib/message/GUILD_MEMBER_ADD.d.ts +14 -0
- package/lib/message/GUILD_MEMBER_ADD.js +1 -0
- package/lib/message/GUILD_MEMBER_REMOVE.d.ts +14 -0
- package/lib/message/GUILD_MEMBER_REMOVE.js +1 -0
- package/lib/message/GUILD_MEMBER_UPDATE.d.ts +14 -0
- package/lib/message/GUILD_MEMBER_UPDATE.js +1 -0
- package/lib/message/GUILD_UPDATE.d.ts +15 -0
- package/lib/message/GUILD_UPDATE.js +1 -0
- package/lib/message/INTERACTION_CREATE.d.ts +53 -0
- package/lib/message/INTERACTION_CREATE.js +1 -0
- package/lib/message/MESSAGE_CREATE.d.ts +1 -0
- package/lib/message/MESSAGE_CREATE.js +1 -0
- package/lib/message/MESSAGE_DELETE.d.ts +1 -0
- package/lib/message/MESSAGE_DELETE.js +1 -0
- package/lib/message/MESSAGE_REACTION_ADD.d.ts +13 -0
- package/lib/message/MESSAGE_REACTION_ADD.js +1 -0
- package/lib/message/MESSAGE_REACTION_REMOVE.d.ts +13 -0
- package/lib/message/MESSAGE_REACTION_REMOVE.js +1 -0
- package/lib/message/PUBLIC_MESSAGE_DELETE.d.ts +15 -0
- package/lib/message/PUBLIC_MESSAGE_DELETE.js +1 -0
- package/lib/message/READY.d.ts +6 -0
- package/lib/message/READY.js +1 -0
- package/lib/message/group/C2C_MESSAGE_CREATE.d.ts +9 -0
- package/lib/message/group/C2C_MESSAGE_CREATE.js +1 -0
- package/lib/message/group/C2C_MSG_RECEIVE.d.ts +4 -0
- package/lib/message/group/C2C_MSG_RECEIVE.js +1 -0
- package/lib/message/group/C2C_MSG_REJECT.d.ts +4 -0
- package/lib/message/group/C2C_MSG_REJECT.js +1 -0
- package/lib/message/group/FRIEND_ADD.d.ts +4 -0
- package/lib/message/group/FRIEND_ADD.js +1 -0
- package/lib/message/group/FRIEND_DEL.d.ts +4 -0
- package/lib/message/group/FRIEND_DEL.js +1 -0
- package/lib/message/group/GROUP_ADD_ROBOT.d.ts +5 -0
- package/lib/message/group/GROUP_ADD_ROBOT.js +1 -0
- package/lib/message/group/GROUP_AT_MESSAGE_CREATE.d.ts +11 -0
- package/lib/message/group/GROUP_AT_MESSAGE_CREATE.js +1 -0
- package/lib/message/group/GROUP_DEL_ROBOT.d.ts +5 -0
- package/lib/message/group/GROUP_DEL_ROBOT.js +1 -0
- package/lib/message/group/GROUP_MSG_RECEIVE.d.ts +5 -0
- package/lib/message/group/GROUP_MSG_RECEIVE.js +1 -0
- package/lib/message/group/GROUP_MSG_REJECT.d.ts +5 -0
- package/lib/message/group/GROUP_MSG_REJECT.js +1 -0
- package/lib/register.d.ts +2 -3
- package/lib/register.js +426 -252
- package/lib/sdk/api.d.ts +10 -567
- package/lib/sdk/api.js +224 -790
- package/lib/sdk/client.webhook.d.ts +9 -0
- package/lib/sdk/{client.js → client.webhook.js} +18 -55
- package/lib/sdk/client.websoket.d.ts +9 -0
- package/lib/sdk/client.websoket.js +52 -97
- package/lib/sdk/config.d.ts +1 -0
- package/lib/sdk/instance.d.ts +3 -0
- package/lib/sdk/instance.js +93 -0
- package/lib/sdk/intents.d.ts +3 -0
- package/lib/sdk/intents.js +25 -90
- package/lib/sdk/message.d.ts +4 -0
- package/lib/sdk/message.group.d.ts +24 -0
- package/lib/sdk/message.group.js +1 -0
- package/lib/sdk/message.guild.d.ts +38 -0
- package/lib/sdk/message.guild.js +1 -0
- package/lib/sdk/message.js +1 -0
- package/lib/sdk/message.public.d.ts +6 -0
- package/lib/sdk/message.public.js +1 -0
- package/lib/sdk/typing.d.ts +22 -11
- package/lib/sdk/typing.js +1 -0
- package/lib/sdk/webhook.secret.d.ts +14 -0
- package/lib/sdk/webhook.secret.js +6 -21
- package/lib/sends.d.ts +29 -0
- package/lib/sends.js +326 -745
- package/lib/utils.d.ts +1 -0
- package/lib/utils.js +7 -12
- package/package.json +9 -5
- package/lib/index.group.js +0 -19
- package/lib/index.guild.js +0 -36
- package/lib/sdk/client.websoket.group.js +0 -221
- package/lib/sdk/client.websoket.guild.js +0 -205
- package/lib/sdk/counter.js +0 -19
- package/lib/sdk/from.js +0 -44
package/lib/sdk/api.js
CHANGED
|
@@ -1,95 +1,65 @@
|
|
|
1
1
|
import axios from 'axios';
|
|
2
2
|
import { config } from './config.js';
|
|
3
3
|
import FormData from 'form-data';
|
|
4
|
-
import { createPicFrom } from '
|
|
4
|
+
import { createPicFrom } from 'alemonjs/utils';
|
|
5
|
+
import { createAxiosInstance } from './instance.js';
|
|
5
6
|
|
|
6
7
|
const BOTS_API_RUL = 'https://bots.qq.com';
|
|
7
8
|
const API_URL_SANDBOX = 'https://sandbox.api.sgroup.qq.com';
|
|
8
9
|
const API_URL = 'https://api.sgroup.qq.com';
|
|
9
10
|
const msgMap = new Map();
|
|
10
11
|
class QQBotAPI {
|
|
11
|
-
|
|
12
|
-
/**
|
|
13
|
-
* 得到鉴权
|
|
14
|
-
* @param app_id
|
|
15
|
-
* @param clientSecret
|
|
16
|
-
* @returns
|
|
17
|
-
*/
|
|
18
|
-
getAuthentication(app_id, clientSecret) {
|
|
19
|
-
return axios.post(`${BOTS_API_RUL}/app/getAppAccessToken`, {
|
|
20
|
-
appId: app_id,
|
|
21
|
-
clientSecret: clientSecret
|
|
22
|
-
});
|
|
23
|
-
}
|
|
24
|
-
/**
|
|
25
|
-
* group
|
|
26
|
-
* @param config
|
|
27
|
-
* @returns
|
|
28
|
-
*/
|
|
29
|
-
groupService(options) {
|
|
12
|
+
getAuthentication() {
|
|
30
13
|
const app_id = config.get('app_id');
|
|
31
|
-
|
|
32
|
-
const
|
|
14
|
+
const secret = config.get('secret');
|
|
15
|
+
const baseUrlAppAccessToken = config.get('base_url_app_access_token');
|
|
16
|
+
const params = {
|
|
17
|
+
url: '/app/getAppAccessToken'
|
|
18
|
+
};
|
|
19
|
+
if (baseUrlAppAccessToken) {
|
|
20
|
+
params.baseURL = baseUrlAppAccessToken;
|
|
21
|
+
}
|
|
33
22
|
const service = axios.create({
|
|
34
|
-
baseURL:
|
|
35
|
-
timeout: 20000
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
23
|
+
baseURL: BOTS_API_RUL,
|
|
24
|
+
timeout: 20000
|
|
25
|
+
});
|
|
26
|
+
return createAxiosInstance(service, {
|
|
27
|
+
...params,
|
|
28
|
+
method: 'post',
|
|
29
|
+
data: {
|
|
30
|
+
appId: `${app_id}`,
|
|
31
|
+
clientSecret: `${secret}`
|
|
39
32
|
}
|
|
40
33
|
});
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
/**
|
|
44
|
-
* guild
|
|
45
|
-
* @param opstion
|
|
46
|
-
* @returns
|
|
47
|
-
*/
|
|
48
|
-
guildServer(opstion) {
|
|
34
|
+
}
|
|
35
|
+
groupService(options) {
|
|
49
36
|
const app_id = config.get('app_id');
|
|
50
|
-
const token = config.get('
|
|
37
|
+
const token = config.get('access_token');
|
|
51
38
|
const sandbox = config.get('sandbox');
|
|
52
39
|
const service = axios.create({
|
|
53
40
|
baseURL: sandbox ? API_URL_SANDBOX : API_URL,
|
|
54
41
|
timeout: 20000,
|
|
55
42
|
headers: {
|
|
56
|
-
|
|
43
|
+
'X-Union-Appid': app_id,
|
|
44
|
+
Authorization: `QQBot ${token}`
|
|
57
45
|
}
|
|
58
46
|
});
|
|
59
|
-
return service
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
const
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
}
|
|
72
|
-
else if (mode === 'guild') {
|
|
73
|
-
return this.guildServer({
|
|
74
|
-
url: '/gateway'
|
|
75
|
-
}).then(res => res?.data);
|
|
76
|
-
}
|
|
77
|
-
else {
|
|
78
|
-
// 默认group
|
|
79
|
-
return this.groupService({
|
|
80
|
-
url: '/gateway'
|
|
81
|
-
}).then(res => res?.data);
|
|
47
|
+
return createAxiosInstance(service, options);
|
|
48
|
+
}
|
|
49
|
+
guildServer(options) {
|
|
50
|
+
return this.groupService(options);
|
|
51
|
+
}
|
|
52
|
+
gateway() {
|
|
53
|
+
const baseUrlGateway = config.get('base_url_gateway');
|
|
54
|
+
const params = {
|
|
55
|
+
url: '/gateway'
|
|
56
|
+
};
|
|
57
|
+
if (baseUrlGateway) {
|
|
58
|
+
params.baseURL = baseUrlGateway;
|
|
82
59
|
}
|
|
60
|
+
return this.groupService(params);
|
|
83
61
|
}
|
|
84
|
-
|
|
85
|
-
* 发送私聊消息
|
|
86
|
-
* @param openid
|
|
87
|
-
* @param content
|
|
88
|
-
* @param msg_id
|
|
89
|
-
* @returns
|
|
90
|
-
* 0 文本 1 图文 2 md 3 ark 4 embed
|
|
91
|
-
*/
|
|
92
|
-
async usersOpenMessages(openid, data) {
|
|
62
|
+
usersOpenMessages(openid, data) {
|
|
93
63
|
const db = {
|
|
94
64
|
...(data.event_id
|
|
95
65
|
? { event_id: data.event_id }
|
|
@@ -102,32 +72,21 @@ class QQBotAPI {
|
|
|
102
72
|
url: `/v2/users/${openid}/messages`,
|
|
103
73
|
method: 'post',
|
|
104
74
|
data: db
|
|
105
|
-
})
|
|
75
|
+
});
|
|
106
76
|
}
|
|
107
|
-
/**
|
|
108
|
-
* 得到消息序列
|
|
109
|
-
* @param MessageId
|
|
110
|
-
* @returns
|
|
111
|
-
*/
|
|
112
77
|
getMessageSeq(MessageId) {
|
|
113
78
|
let seq = msgMap.get(MessageId) || 0;
|
|
114
79
|
seq++;
|
|
115
80
|
msgMap.set(MessageId, seq);
|
|
116
|
-
// 如果映射表大小超过 100,则删除最早添加的 MessageId
|
|
117
81
|
if (msgMap.size > 100) {
|
|
118
82
|
const firstKey = msgMap.keys().next().value;
|
|
119
|
-
if (firstKey)
|
|
83
|
+
if (firstKey) {
|
|
120
84
|
msgMap.delete(firstKey);
|
|
85
|
+
}
|
|
121
86
|
}
|
|
122
87
|
return seq;
|
|
123
88
|
}
|
|
124
|
-
|
|
125
|
-
* 发送群聊消息
|
|
126
|
-
* @param group_openid
|
|
127
|
-
* @param data
|
|
128
|
-
* @returns
|
|
129
|
-
*/
|
|
130
|
-
async groupOpenMessages(group_openid, data) {
|
|
89
|
+
groupOpenMessages(group_openid, data) {
|
|
131
90
|
const db = {
|
|
132
91
|
...(data.event_id
|
|
133
92
|
? { event_id: data.event_id }
|
|
@@ -140,63 +99,16 @@ class QQBotAPI {
|
|
|
140
99
|
url: `/v2/groups/${group_openid}/messages`,
|
|
141
100
|
method: 'post',
|
|
142
101
|
data: db
|
|
143
|
-
})
|
|
144
|
-
}
|
|
145
|
-
|
|
146
|
-
* 发送私聊富媒体文件
|
|
147
|
-
* @param openid
|
|
148
|
-
* @param data
|
|
149
|
-
* @returns
|
|
150
|
-
* 1 图文 2 视频 3 语言 4 文件
|
|
151
|
-
* 图片:png/jpg,视频:mp4,语音:silk
|
|
152
|
-
*/
|
|
153
|
-
async postRichMediaByUsers(openid, data) {
|
|
154
|
-
return this.groupService({
|
|
155
|
-
url: `/v2/users/${openid}/files`,
|
|
156
|
-
method: 'post',
|
|
157
|
-
data: data
|
|
158
|
-
}).then(res => res?.data);
|
|
159
|
-
}
|
|
160
|
-
/**
|
|
161
|
-
* 发送私聊富媒体文件
|
|
162
|
-
* @param openid
|
|
163
|
-
* @param data
|
|
164
|
-
* @returns
|
|
165
|
-
* 1 图文 2 视频 3 语言 4 文件
|
|
166
|
-
* 图片:png/jpg,视频:mp4,语音:silk
|
|
167
|
-
*/
|
|
168
|
-
async userFiles(openid, data) {
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
postRichMediaByUser(openid, data) {
|
|
169
105
|
return this.groupService({
|
|
170
106
|
url: `/v2/users/${openid}/files`,
|
|
171
107
|
method: 'post',
|
|
172
108
|
data: data
|
|
173
|
-
})
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
* 发送群里文件
|
|
177
|
-
* @param openid
|
|
178
|
-
* @param data
|
|
179
|
-
* @returns
|
|
180
|
-
* 1 图文 2 视频 3 语言 4 文件
|
|
181
|
-
* 图片:png/jpg,视频:mp4,语音:silk
|
|
182
|
-
*/
|
|
183
|
-
async postRichMediaByGroup(openid, data) {
|
|
184
|
-
return this.groupService({
|
|
185
|
-
url: `/v2/groups/${openid}/files`,
|
|
186
|
-
method: 'post',
|
|
187
|
-
data: {
|
|
188
|
-
srv_send_msg: false,
|
|
189
|
-
...data
|
|
190
|
-
}
|
|
191
|
-
}).then(res => res?.data);
|
|
192
|
-
}
|
|
193
|
-
/**
|
|
194
|
-
*
|
|
195
|
-
* @param openid
|
|
196
|
-
* @param data
|
|
197
|
-
* @returns
|
|
198
|
-
*/
|
|
199
|
-
async groupsFiles(openid, data) {
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
postRichMediaByGroup(openid, data) {
|
|
200
112
|
return this.groupService({
|
|
201
113
|
url: `/v2/groups/${openid}/files`,
|
|
202
114
|
method: 'post',
|
|
@@ -204,44 +116,20 @@ class QQBotAPI {
|
|
|
204
116
|
srv_send_msg: false,
|
|
205
117
|
...data
|
|
206
118
|
}
|
|
207
|
-
})
|
|
208
|
-
}
|
|
209
|
-
|
|
210
|
-
*
|
|
211
|
-
* @param openid
|
|
212
|
-
* @param message_id
|
|
213
|
-
* @returns
|
|
214
|
-
*/
|
|
215
|
-
async userMessageDelete(openid, message_id) {
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
userMessageDelete(openid, message_id) {
|
|
216
122
|
return this.groupService({
|
|
217
123
|
url: `/v2/users/${openid}/messages/${message_id}`,
|
|
218
124
|
method: 'delete'
|
|
219
|
-
})
|
|
220
|
-
}
|
|
221
|
-
|
|
222
|
-
*
|
|
223
|
-
* @param group_openid
|
|
224
|
-
* @param message_id
|
|
225
|
-
* @returns
|
|
226
|
-
*/
|
|
227
|
-
async grouMessageDelte(group_openid, message_id) {
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
grouMessageDelte(group_openid, message_id) {
|
|
228
128
|
return this.groupService({
|
|
229
129
|
url: `/v2/groups/${group_openid}/messages/${message_id}`,
|
|
230
130
|
method: 'delete'
|
|
231
|
-
})
|
|
232
|
-
}
|
|
233
|
-
/**
|
|
234
|
-
* ************
|
|
235
|
-
* 消息-图片接口
|
|
236
|
-
* ***********
|
|
237
|
-
*/
|
|
238
|
-
/**
|
|
239
|
-
*
|
|
240
|
-
* @param channel_id
|
|
241
|
-
* @param message
|
|
242
|
-
* @param image
|
|
243
|
-
* @returns
|
|
244
|
-
*/
|
|
131
|
+
});
|
|
132
|
+
}
|
|
245
133
|
async channelsMessages(channel_id, message, image) {
|
|
246
134
|
const formdata = new FormData();
|
|
247
135
|
for (const key in message) {
|
|
@@ -250,7 +138,7 @@ class QQBotAPI {
|
|
|
250
138
|
}
|
|
251
139
|
}
|
|
252
140
|
if (image) {
|
|
253
|
-
const from = await createPicFrom(image);
|
|
141
|
+
const from = await createPicFrom({ image });
|
|
254
142
|
if (from) {
|
|
255
143
|
const { picData, name } = from;
|
|
256
144
|
formdata.append('file_image', picData, name);
|
|
@@ -264,14 +152,8 @@ class QQBotAPI {
|
|
|
264
152
|
'Content-Type': `multipart/form-data; boundary=${dary}`
|
|
265
153
|
},
|
|
266
154
|
data: formdata
|
|
267
|
-
})
|
|
268
|
-
}
|
|
269
|
-
/**
|
|
270
|
-
* 私聊发送
|
|
271
|
-
* @param id 私信传频道id,公信传子频道id
|
|
272
|
-
* @param message {消息编号,图片,内容}
|
|
273
|
-
* @returns
|
|
274
|
-
*/
|
|
155
|
+
});
|
|
156
|
+
}
|
|
275
157
|
async dmsMessages(guild_id, message, image) {
|
|
276
158
|
const formdata = new FormData();
|
|
277
159
|
for (const key in message) {
|
|
@@ -280,7 +162,7 @@ class QQBotAPI {
|
|
|
280
162
|
}
|
|
281
163
|
}
|
|
282
164
|
if (image) {
|
|
283
|
-
const from = await createPicFrom(image);
|
|
165
|
+
const from = await createPicFrom({ image });
|
|
284
166
|
if (from) {
|
|
285
167
|
const { picData, name } = from;
|
|
286
168
|
formdata.append('file_image', picData, name);
|
|
@@ -294,275 +176,131 @@ class QQBotAPI {
|
|
|
294
176
|
'Content-Type': `multipart/form-data; boundary=${dary}`
|
|
295
177
|
},
|
|
296
178
|
data: formdata
|
|
297
|
-
})
|
|
298
|
-
}
|
|
299
|
-
|
|
300
|
-
* ********
|
|
301
|
-
* 用户api
|
|
302
|
-
* *******
|
|
303
|
-
*/
|
|
304
|
-
/**
|
|
305
|
-
* 获取用户详情
|
|
306
|
-
* @param message
|
|
307
|
-
* @returns
|
|
308
|
-
*/
|
|
309
|
-
async usersMe() {
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
usersMe() {
|
|
310
182
|
return this.guildServer({
|
|
311
183
|
method: 'get',
|
|
312
|
-
url:
|
|
313
|
-
})
|
|
314
|
-
}
|
|
315
|
-
|
|
316
|
-
* 获取用户频道列表
|
|
317
|
-
* @param message
|
|
318
|
-
* @returns
|
|
319
|
-
*/
|
|
320
|
-
async usersMeGuilds(params) {
|
|
184
|
+
url: '/users/@me'
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
usersMeGuilds(params) {
|
|
321
188
|
return this.guildServer({
|
|
322
189
|
method: 'get',
|
|
323
|
-
url:
|
|
190
|
+
url: '/users/@me/guilds',
|
|
324
191
|
params
|
|
325
|
-
})
|
|
326
|
-
}
|
|
327
|
-
|
|
328
|
-
* **********
|
|
329
|
-
* 频道api
|
|
330
|
-
* **********
|
|
331
|
-
*/
|
|
332
|
-
/**
|
|
333
|
-
* 获取频道详细
|
|
334
|
-
* @param guild_id
|
|
335
|
-
* @returns
|
|
336
|
-
*/
|
|
337
|
-
async guilds(guild_id) {
|
|
192
|
+
});
|
|
193
|
+
}
|
|
194
|
+
guilds(guild_id) {
|
|
338
195
|
return this.guildServer({
|
|
339
196
|
method: 'get',
|
|
340
197
|
url: `/guilds/${guild_id}`
|
|
341
|
-
})
|
|
342
|
-
}
|
|
343
|
-
|
|
344
|
-
* ************
|
|
345
|
-
* 子频道api
|
|
346
|
-
* ***********
|
|
347
|
-
*/
|
|
348
|
-
/**
|
|
349
|
-
* 获取子频道列表
|
|
350
|
-
* @param guild_id
|
|
351
|
-
* @returns
|
|
352
|
-
*/
|
|
353
|
-
async guildsChannels(guild_id) {
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
guildsChannels(guild_id) {
|
|
354
201
|
return this.guildServer({
|
|
355
202
|
method: 'get',
|
|
356
203
|
url: `/guilds/${guild_id}/channels`
|
|
357
|
-
})
|
|
358
|
-
}
|
|
359
|
-
|
|
360
|
-
* 获取子频道详情
|
|
361
|
-
* @param channel_id
|
|
362
|
-
* @returns
|
|
363
|
-
*/
|
|
364
|
-
async channels(channel_id) {
|
|
204
|
+
});
|
|
205
|
+
}
|
|
206
|
+
channels(channel_id) {
|
|
365
207
|
return this.guildServer({
|
|
366
208
|
method: 'get',
|
|
367
209
|
url: `/channels/${channel_id}`
|
|
368
|
-
})
|
|
369
|
-
}
|
|
370
|
-
|
|
371
|
-
* 创建子频道
|
|
372
|
-
* @param guild_id
|
|
373
|
-
* @returns
|
|
374
|
-
*/
|
|
375
|
-
async guildsChannelsCreate(guild_id, data) {
|
|
210
|
+
});
|
|
211
|
+
}
|
|
212
|
+
guildsChannelsCreate(guild_id, data) {
|
|
376
213
|
return this.guildServer({
|
|
377
214
|
method: 'post',
|
|
378
215
|
url: `/guilds/${guild_id}/channels`,
|
|
379
216
|
data
|
|
380
|
-
})
|
|
381
|
-
}
|
|
382
|
-
|
|
383
|
-
* 创建子频道
|
|
384
|
-
* @param channel_id
|
|
385
|
-
* @returns
|
|
386
|
-
*/
|
|
387
|
-
async guildsChannelsUpdate(channel_id, data) {
|
|
217
|
+
});
|
|
218
|
+
}
|
|
219
|
+
guildsChannelsUpdate(channel_id, data) {
|
|
388
220
|
return this.guildServer({
|
|
389
221
|
method: 'PATCH',
|
|
390
222
|
url: `/channels/${channel_id}`,
|
|
391
223
|
data
|
|
392
|
-
})
|
|
393
|
-
}
|
|
394
|
-
|
|
395
|
-
* 删除子频道
|
|
396
|
-
* @param channel_id
|
|
397
|
-
* @param data
|
|
398
|
-
* @returns
|
|
399
|
-
*/
|
|
400
|
-
async guildsChannelsdelete(channel_id, data) {
|
|
224
|
+
});
|
|
225
|
+
}
|
|
226
|
+
guildsChannelsdelete(channel_id, data) {
|
|
401
227
|
return this.guildServer({
|
|
402
228
|
method: 'DELETE',
|
|
403
229
|
url: `/channels/${channel_id}`,
|
|
404
230
|
data
|
|
405
|
-
})
|
|
406
|
-
}
|
|
407
|
-
|
|
408
|
-
* 获取在线成员数
|
|
409
|
-
* @param channel_id
|
|
410
|
-
* @returns
|
|
411
|
-
*/
|
|
412
|
-
async channelsChannelOnlineNums(channel_id) {
|
|
231
|
+
});
|
|
232
|
+
}
|
|
233
|
+
channelsChannelOnlineNums(channel_id) {
|
|
413
234
|
return this.guildServer({
|
|
414
235
|
method: 'GET',
|
|
415
236
|
url: `/channels/${channel_id}/online_nums`
|
|
416
|
-
})
|
|
417
|
-
}
|
|
418
|
-
|
|
419
|
-
* *********
|
|
420
|
-
* 成员api
|
|
421
|
-
* *********
|
|
422
|
-
*/
|
|
423
|
-
/**
|
|
424
|
-
* 获取频道成员列表
|
|
425
|
-
* @param guild_id
|
|
426
|
-
* @returns
|
|
427
|
-
*/
|
|
428
|
-
async guildsMembers(guild_id, params) {
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
guildsMembers(guild_id, params) {
|
|
429
240
|
return this.guildServer({
|
|
430
241
|
method: 'GET',
|
|
431
242
|
url: `/guilds/${guild_id}/members`,
|
|
432
243
|
params
|
|
433
|
-
})
|
|
434
|
-
}
|
|
435
|
-
|
|
436
|
-
* 获取频道身份组成员列表
|
|
437
|
-
* @param guild_id
|
|
438
|
-
* @param role_id
|
|
439
|
-
* @param params
|
|
440
|
-
* @returns
|
|
441
|
-
*/
|
|
442
|
-
async guildsRolesMembers(guild_id, role_id, params) {
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
guildsRolesMembers(guild_id, role_id, params) {
|
|
443
247
|
return this.guildServer({
|
|
444
248
|
method: 'GET',
|
|
445
249
|
url: `/guilds/${guild_id}/roles/${role_id}/members`,
|
|
446
250
|
params
|
|
447
|
-
})
|
|
448
|
-
}
|
|
449
|
-
|
|
450
|
-
* 获取成员详情
|
|
451
|
-
* @param guild_id
|
|
452
|
-
* @param user_id
|
|
453
|
-
* @returns
|
|
454
|
-
*/
|
|
455
|
-
async guildsMembersMessage(guild_id, user_id) {
|
|
251
|
+
});
|
|
252
|
+
}
|
|
253
|
+
guildsMembersMessage(guild_id, user_id) {
|
|
456
254
|
return this.guildServer({
|
|
457
255
|
method: 'GET',
|
|
458
256
|
url: `/guilds/${guild_id}/members/${user_id}`
|
|
459
|
-
})
|
|
460
|
-
}
|
|
461
|
-
|
|
462
|
-
* 删除频道成员
|
|
463
|
-
* @param guild_id
|
|
464
|
-
* @param user_id
|
|
465
|
-
* @returns
|
|
466
|
-
*/
|
|
467
|
-
async guildsMembersDelete(guild_id, user_id) {
|
|
257
|
+
});
|
|
258
|
+
}
|
|
259
|
+
guildsMembersDelete(guild_id, user_id) {
|
|
468
260
|
return this.guildServer({
|
|
469
261
|
method: 'DELETE',
|
|
470
262
|
url: `/guilds/${guild_id}/members/${user_id}`
|
|
471
|
-
})
|
|
472
|
-
}
|
|
473
|
-
|
|
474
|
-
* 获取指定消息
|
|
475
|
-
* @param channel_id
|
|
476
|
-
* @param message_id
|
|
477
|
-
* @returns
|
|
478
|
-
*/
|
|
479
|
-
async channelsMessagesById(channel_id, message_id) {
|
|
263
|
+
});
|
|
264
|
+
}
|
|
265
|
+
channelsMessagesById(channel_id, message_id) {
|
|
480
266
|
return this.guildServer({
|
|
481
267
|
method: 'GET',
|
|
482
268
|
url: `/channels/${channel_id}/messages/${message_id}`
|
|
483
|
-
})
|
|
484
|
-
}
|
|
485
|
-
|
|
486
|
-
* 撤回消息
|
|
487
|
-
* @param channel_id
|
|
488
|
-
* @param message_id
|
|
489
|
-
* @param hidetip
|
|
490
|
-
* @returns
|
|
491
|
-
*/
|
|
492
|
-
async channelsMessagesDelete(channel_id, message_id, hidetip = true) {
|
|
269
|
+
});
|
|
270
|
+
}
|
|
271
|
+
channelsMessagesDelete(channel_id, message_id, hidetip = true) {
|
|
493
272
|
return this.guildServer({
|
|
494
273
|
method: 'DELETE',
|
|
495
274
|
url: `/channels/${channel_id}/messages/${message_id}?hidetip=${hidetip}`
|
|
496
|
-
})
|
|
497
|
-
}
|
|
498
|
-
|
|
499
|
-
* ***********
|
|
500
|
-
* 频道身份api
|
|
501
|
-
* ***********
|
|
502
|
-
*/
|
|
503
|
-
/**
|
|
504
|
-
* 获取频道身份组列表
|
|
505
|
-
* @param guild_id 频道id
|
|
506
|
-
* @returns
|
|
507
|
-
*/
|
|
508
|
-
async guildsRoles(guild_id) {
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
guildsRoles(guild_id) {
|
|
509
278
|
return this.guildServer({
|
|
510
279
|
method: 'GET',
|
|
511
280
|
url: `/guilds/${guild_id}/roles`
|
|
512
|
-
})
|
|
513
|
-
}
|
|
514
|
-
|
|
515
|
-
* 创建频道身份组
|
|
516
|
-
* @param guild_id 频道id
|
|
517
|
-
* @param {object} data 参数
|
|
518
|
-
* @param {object?} data.name 身份组名称
|
|
519
|
-
* @param {object?} data.color ARGB 的 HEX 十六进制颜色值转换后的十进制数值
|
|
520
|
-
* @param {object?} data.hoist 在成员列表中单独展示: 0-否, 1-是
|
|
521
|
-
* @returns
|
|
522
|
-
*/
|
|
523
|
-
async guildsRolesPost(guild_id, data) {
|
|
281
|
+
});
|
|
282
|
+
}
|
|
283
|
+
guildsRolesPost(guild_id, data) {
|
|
524
284
|
return this.guildServer({
|
|
525
285
|
method: 'POST',
|
|
526
286
|
url: `/guilds/${guild_id}/roles`,
|
|
527
287
|
data
|
|
528
|
-
})
|
|
529
|
-
}
|
|
530
|
-
|
|
531
|
-
* 修改频道身份组
|
|
532
|
-
* @param guild_id 频道id
|
|
533
|
-
* @param {object} data 参数
|
|
534
|
-
* @param {object?} data.name 身份组名称
|
|
535
|
-
* @param {object?} data.color ARGB 的 HEX 十六进制颜色值转换后的十进制数值
|
|
536
|
-
* @param {object?} data.hoist 在成员列表中单独展示: 0-否, 1-是
|
|
537
|
-
* @returns
|
|
538
|
-
*/
|
|
539
|
-
async guildsRolesPatch(guild_id, role_id, data) {
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
guildsRolesPatch(guild_id, role_id, data) {
|
|
540
291
|
return this.guildServer({
|
|
541
292
|
method: 'PATCH',
|
|
542
293
|
url: `/guilds/${guild_id}/roles/${role_id}`,
|
|
543
294
|
data
|
|
544
|
-
})
|
|
545
|
-
}
|
|
546
|
-
|
|
547
|
-
* 删除频道身份组
|
|
548
|
-
* @param guild_id 频道id
|
|
549
|
-
* @param role_id 身份组id
|
|
550
|
-
*/
|
|
551
|
-
async guildsRolesDelete(guild_id, role_id) {
|
|
295
|
+
});
|
|
296
|
+
}
|
|
297
|
+
guildsRolesDelete(guild_id, role_id) {
|
|
552
298
|
return this.guildServer({
|
|
553
299
|
method: 'DELETE',
|
|
554
300
|
url: `/guilds/${guild_id}/roles/${role_id}`
|
|
555
|
-
})
|
|
556
|
-
}
|
|
557
|
-
|
|
558
|
-
* 将成员添加到频道身份组
|
|
559
|
-
* @param guild_id 频道id
|
|
560
|
-
* @param channel_id 子频道id
|
|
561
|
-
* @param user_id 用户id
|
|
562
|
-
* @param role_id 身份组id
|
|
563
|
-
* @returns
|
|
564
|
-
*/
|
|
565
|
-
async guildsRolesMembersPut(guild_id, channel_id, user_id, role_id) {
|
|
301
|
+
});
|
|
302
|
+
}
|
|
303
|
+
guildsRolesMembersPut(guild_id, channel_id, user_id, role_id) {
|
|
566
304
|
return this.guildServer({
|
|
567
305
|
method: 'PUT',
|
|
568
306
|
url: `/guilds/${guild_id}/members/${user_id}/roles/${role_id}`,
|
|
@@ -571,17 +309,9 @@ class QQBotAPI {
|
|
|
571
309
|
id: channel_id
|
|
572
310
|
}
|
|
573
311
|
}
|
|
574
|
-
})
|
|
575
|
-
}
|
|
576
|
-
|
|
577
|
-
* 将成员从频道身份组移除
|
|
578
|
-
* @param guild_id 频道id
|
|
579
|
-
* @param channel_id 子频道id
|
|
580
|
-
* @param user_id 用户id
|
|
581
|
-
* @param role_id 身份组id
|
|
582
|
-
* @returns
|
|
583
|
-
*/
|
|
584
|
-
async guildsRolesMembersDelete(guild_id, channel_id, user_id, role_id) {
|
|
312
|
+
});
|
|
313
|
+
}
|
|
314
|
+
guildsRolesMembersDelete(guild_id, channel_id, user_id, role_id) {
|
|
585
315
|
return this.guildServer({
|
|
586
316
|
method: 'DELETE',
|
|
587
317
|
url: `/guilds/${guild_id}/members/${user_id}/roles/${role_id}`,
|
|
@@ -590,31 +320,15 @@ class QQBotAPI {
|
|
|
590
320
|
id: channel_id
|
|
591
321
|
}
|
|
592
322
|
}
|
|
593
|
-
})
|
|
594
|
-
}
|
|
595
|
-
|
|
596
|
-
* **********
|
|
597
|
-
* 子频道权限api
|
|
598
|
-
* **********
|
|
599
|
-
*/
|
|
600
|
-
/**
|
|
601
|
-
* 获取子频道用户权限
|
|
602
|
-
* @param channel_id 子频道id
|
|
603
|
-
* @param user_id 用户id
|
|
604
|
-
*/
|
|
605
|
-
async channelsPermissions(channel_id, user_id) {
|
|
323
|
+
});
|
|
324
|
+
}
|
|
325
|
+
channelsPermissions(channel_id, user_id) {
|
|
606
326
|
return this.guildServer({
|
|
607
327
|
method: 'GET',
|
|
608
328
|
url: `/channels/${channel_id}/members/${user_id}/permissions`
|
|
609
|
-
})
|
|
610
|
-
}
|
|
611
|
-
|
|
612
|
-
* 修改子频道用户权限
|
|
613
|
-
* @param channel_id 子频道id
|
|
614
|
-
* @param user_id 用户id
|
|
615
|
-
* @param 参数包括add和remove两个字段分别表示授予的权限以及删除的权限。要授予用户权限即把add对应位置 1,删除用户权限即把remove对应位置 1。当两个字段同一位都为 1,表现为删除权限。
|
|
616
|
-
*/
|
|
617
|
-
async channelsPermissionsPut(channel_id, user_id, add, remove) {
|
|
329
|
+
});
|
|
330
|
+
}
|
|
331
|
+
channelsPermissionsPut(channel_id, user_id, add, remove) {
|
|
618
332
|
return this.guildServer({
|
|
619
333
|
method: 'PUT',
|
|
620
334
|
url: `/channels/${channel_id}/members/${user_id}/permissions`,
|
|
@@ -622,466 +336,186 @@ class QQBotAPI {
|
|
|
622
336
|
add,
|
|
623
337
|
remove
|
|
624
338
|
}
|
|
625
|
-
})
|
|
626
|
-
}
|
|
627
|
-
|
|
628
|
-
* *******
|
|
629
|
-
* 消息api
|
|
630
|
-
* ********
|
|
631
|
-
*/
|
|
632
|
-
/**
|
|
633
|
-
* ************
|
|
634
|
-
* 消息频率api
|
|
635
|
-
* **********
|
|
636
|
-
*/
|
|
637
|
-
/**
|
|
638
|
-
* 查询频道消息频率限制
|
|
639
|
-
* @param guild_id 频道id
|
|
640
|
-
* @returns
|
|
641
|
-
*/
|
|
642
|
-
async guildsMessageSetting(guild_id) {
|
|
339
|
+
});
|
|
340
|
+
}
|
|
341
|
+
guildsMessageSetting(guild_id) {
|
|
643
342
|
return this.guildServer({
|
|
644
343
|
method: 'GET',
|
|
645
344
|
url: `/guilds/${guild_id}/message/setting`
|
|
646
|
-
})
|
|
647
|
-
}
|
|
648
|
-
|
|
649
|
-
* ***********
|
|
650
|
-
* 私信api
|
|
651
|
-
* **********
|
|
652
|
-
*/
|
|
653
|
-
/**
|
|
654
|
-
* 创建私信会话
|
|
655
|
-
* @param recipient_id 接收者 id
|
|
656
|
-
* @param source_guild_id 源频道 id
|
|
657
|
-
* @returns
|
|
658
|
-
*/
|
|
659
|
-
async usersMeDms() {
|
|
345
|
+
});
|
|
346
|
+
}
|
|
347
|
+
usersMeDms() {
|
|
660
348
|
return this.guildServer({
|
|
661
349
|
method: 'POST',
|
|
662
|
-
url:
|
|
663
|
-
})
|
|
664
|
-
}
|
|
665
|
-
|
|
666
|
-
* 撤回私信
|
|
667
|
-
* @param guild_id
|
|
668
|
-
* @param data
|
|
669
|
-
* @returns
|
|
670
|
-
*/
|
|
671
|
-
async dmsMessageDelete(guild_id, message_id, hidetip = true) {
|
|
350
|
+
url: '/users/@me/dms'
|
|
351
|
+
});
|
|
352
|
+
}
|
|
353
|
+
dmsMessageDelete(guild_id, message_id, hidetip = true) {
|
|
672
354
|
return this.guildServer({
|
|
673
355
|
method: 'DELETE',
|
|
674
356
|
url: `/dms/${guild_id}/messages/${message_id}?hidetip=${hidetip}`
|
|
675
|
-
})
|
|
676
|
-
}
|
|
677
|
-
|
|
678
|
-
* *********
|
|
679
|
-
* 禁言api
|
|
680
|
-
* *******
|
|
681
|
-
*/
|
|
682
|
-
/**
|
|
683
|
-
* 全体禁言(非管理员)
|
|
684
|
-
* @param guild_id 频道id
|
|
685
|
-
* @param data { mute_end_timestamp:禁言结束时间戳, mute_seconds:禁言时长 } 两个参数必须传一个 优先级 mute_end_timestamp > mute_seconds
|
|
686
|
-
* 将mute_end_timestamp或mute_seconds传值为字符串'0',则表示解除全体禁言
|
|
687
|
-
*/
|
|
688
|
-
async guildsMuteAll(guild_id, data) {
|
|
357
|
+
});
|
|
358
|
+
}
|
|
359
|
+
guildsMuteAll(guild_id, data) {
|
|
689
360
|
return this.guildServer({
|
|
690
361
|
method: 'PATCH',
|
|
691
362
|
url: `/guilds/${guild_id}/mute`,
|
|
692
363
|
data
|
|
693
|
-
})
|
|
694
|
-
}
|
|
695
|
-
|
|
696
|
-
* 频道指定成员禁言
|
|
697
|
-
* @param guild_id 频道id
|
|
698
|
-
* @param user_id 用户id
|
|
699
|
-
* @param data { mute_end_timestamp:禁言结束时间戳, mute_seconds:禁言时长 } 两个参数必须传一个 优先级 mute_end_timestamp > mute_seconds
|
|
700
|
-
* 将mute_end_timestamp或mute_seconds传值为字符串'0',则表示解除禁言
|
|
701
|
-
* @returns
|
|
702
|
-
*/
|
|
703
|
-
async guildsMemberMute(guild_id, user_id, data) {
|
|
364
|
+
});
|
|
365
|
+
}
|
|
366
|
+
guildsMemberMute(guild_id, user_id, data) {
|
|
704
367
|
return this.guildServer({
|
|
705
368
|
method: 'PATCH',
|
|
706
369
|
url: `/guilds/${guild_id}/members/${user_id}/mute`,
|
|
707
370
|
data
|
|
708
|
-
})
|
|
709
|
-
}
|
|
710
|
-
|
|
711
|
-
* 频道批量禁言
|
|
712
|
-
* @param guild_id 频道id
|
|
713
|
-
* @param data { mute_end_timestamp:禁言结束时间戳, mute_seconds:禁言时长, user_ids:用户id数组 } 两个参数必须传一个 优先级 mute_end_timestamp > mute_seconds
|
|
714
|
-
* 将mute_end_timestamp或mute_seconds传值为字符串'0',则表示解除禁言
|
|
715
|
-
*/
|
|
716
|
-
async guildsMute(guild_id, data) {
|
|
371
|
+
});
|
|
372
|
+
}
|
|
373
|
+
guildsMute(guild_id, data) {
|
|
717
374
|
return this.guildServer({
|
|
718
375
|
method: 'PATCH',
|
|
719
376
|
url: `/guilds/${guild_id}/mute`,
|
|
720
377
|
data
|
|
721
|
-
})
|
|
722
|
-
}
|
|
723
|
-
|
|
724
|
-
* *******
|
|
725
|
-
* 公告api
|
|
726
|
-
* *******
|
|
727
|
-
*/
|
|
728
|
-
/**
|
|
729
|
-
* 创建频道公告
|
|
730
|
-
* 公告类型分为 消息类型的频道公告 和 推荐子频道类型的频道公告
|
|
731
|
-
* 详见 https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/announces/post_guild_announces.html#%E5%8A%9F%E8%83%BD%E6%8F%8F%E8%BF%B0
|
|
732
|
-
* @param guild_id 频道id
|
|
733
|
-
* @param data { message_id:消息id, channel_id:频道id, announces_type:公告类型, recommend_channels:推荐频道id数组 }
|
|
734
|
-
* @param channel_id 子频道id 消息id存在时必须传
|
|
735
|
-
* @param announces_type 0:成员公告 1:欢迎公告 默认为 0
|
|
736
|
-
* @param recommend_channels 推荐频道id数组 "recommend_channels": [{ "channel_id": "xxxx","introduce": "推荐语" }]
|
|
737
|
-
* @returns 返回Announces 对象 (https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/announces/model.html#Announces)
|
|
738
|
-
*/
|
|
739
|
-
async guildsAnnounces(guild_id, data) {
|
|
378
|
+
});
|
|
379
|
+
}
|
|
380
|
+
guildsAnnounces(guild_id, data) {
|
|
740
381
|
return this.guildServer({
|
|
741
382
|
method: 'POST',
|
|
742
383
|
url: `/guilds/${guild_id}/announces`,
|
|
743
384
|
data
|
|
744
|
-
})
|
|
745
|
-
}
|
|
746
|
-
|
|
747
|
-
* 删除频道公告
|
|
748
|
-
* @param guild_id 频道id
|
|
749
|
-
* @param message_id 消息id message_id 有值时,会校验 message_id 合法性,若不校验校验 message_id,请将 message_id 设置为 all
|
|
750
|
-
* @returns
|
|
751
|
-
*/
|
|
752
|
-
async guildsAnnouncesDelete(guild_id, message_id) {
|
|
385
|
+
});
|
|
386
|
+
}
|
|
387
|
+
guildsAnnouncesDelete(guild_id, message_id) {
|
|
753
388
|
return this.guildServer({
|
|
754
389
|
method: 'DELETE',
|
|
755
390
|
url: `/guilds/${guild_id}/announces/${message_id}`
|
|
756
|
-
})
|
|
757
|
-
}
|
|
758
|
-
|
|
759
|
-
* **********
|
|
760
|
-
* 精华消息api
|
|
761
|
-
* **********
|
|
762
|
-
*/
|
|
763
|
-
/**
|
|
764
|
-
* 添加精华消息
|
|
765
|
-
* @param channel_id 频道id
|
|
766
|
-
* @param message_id 消息id
|
|
767
|
-
* @returns 返回 PinsMessage对象 { "guild_id": "xxxxxx", "channel_id": "xxxxxx", "message_ids": ["xxxxx"]}
|
|
768
|
-
* @returns message_ids 为当前请求后子频道内所有精华消息 message_id 数组
|
|
769
|
-
*/
|
|
770
|
-
async channelsPinsPut(channel_id, message_id) {
|
|
391
|
+
});
|
|
392
|
+
}
|
|
393
|
+
channelsPinsPut(channel_id, message_id) {
|
|
771
394
|
return this.guildServer({
|
|
772
395
|
method: 'PUT',
|
|
773
396
|
url: `/channels/${channel_id}/pins/${message_id}`
|
|
774
|
-
})
|
|
775
|
-
}
|
|
776
|
-
|
|
777
|
-
* 删除精华消息
|
|
778
|
-
* @param channel_id 子频道id
|
|
779
|
-
* @param message_id 消息id
|
|
780
|
-
* 删除子频道内全部精华消息,请将 message_id 设置为 all
|
|
781
|
-
* @returns
|
|
782
|
-
*/
|
|
783
|
-
async channelsPinsDelete(channel_id, message_id) {
|
|
397
|
+
});
|
|
398
|
+
}
|
|
399
|
+
channelsPinsDelete(channel_id, message_id) {
|
|
784
400
|
return this.guildServer({
|
|
785
401
|
method: 'DELETE',
|
|
786
402
|
url: `/channels/${channel_id}/pins/${message_id}`
|
|
787
|
-
})
|
|
788
|
-
}
|
|
789
|
-
|
|
790
|
-
* 获取精华消息
|
|
791
|
-
* @param channel_id 子频道id
|
|
792
|
-
* @returns 返回 PinsMessage对象 { "guild_id": "xxxxxx", "channel_id": "xxxxxx", "message_ids": ["xxxxx"]}
|
|
793
|
-
* @returns message_ids 为当前请求后子频道内所有精华消息 message_id 数组
|
|
794
|
-
*/
|
|
795
|
-
async channelsPins(channel_id) {
|
|
403
|
+
});
|
|
404
|
+
}
|
|
405
|
+
channelsPins(channel_id) {
|
|
796
406
|
return this.guildServer({
|
|
797
407
|
method: 'GET',
|
|
798
408
|
url: `/channels/${channel_id}/pins`
|
|
799
|
-
})
|
|
800
|
-
}
|
|
801
|
-
|
|
802
|
-
* ********
|
|
803
|
-
* 日程api
|
|
804
|
-
* *******
|
|
805
|
-
*/
|
|
806
|
-
/**
|
|
807
|
-
* 获取频道日程列表
|
|
808
|
-
* @param channel_id 子频道id
|
|
809
|
-
* @returns 返回 Schedule 对象数组(详见https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/schedule/model.html#schedule)
|
|
810
|
-
*/
|
|
811
|
-
async channelsSchedules(channel_id) {
|
|
409
|
+
});
|
|
410
|
+
}
|
|
411
|
+
channelsSchedules(channel_id) {
|
|
812
412
|
return this.guildServer({
|
|
813
413
|
method: 'GET',
|
|
814
414
|
url: `/channels/${channel_id}/schedules`
|
|
815
|
-
})
|
|
816
|
-
}
|
|
817
|
-
|
|
818
|
-
* 获取频道日程详情
|
|
819
|
-
* @param channel_id 子频道id
|
|
820
|
-
* @param schedule_id 日程id
|
|
821
|
-
* @returns 返回 Schedule 对象(详见https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/schedule/model.html#schedule)
|
|
822
|
-
*/
|
|
823
|
-
async channelsSchedulesSchedule(channel_id, schedule_id) {
|
|
415
|
+
});
|
|
416
|
+
}
|
|
417
|
+
channelsSchedulesSchedule(channel_id, schedule_id) {
|
|
824
418
|
return this.guildServer({
|
|
825
419
|
method: 'GET',
|
|
826
420
|
url: `/channels/${channel_id}/schedules/${schedule_id}`
|
|
827
|
-
})
|
|
828
|
-
}
|
|
829
|
-
|
|
830
|
-
* 创建频道日程
|
|
831
|
-
* @param channel_id 子频道id
|
|
832
|
-
* @param name 日程名称
|
|
833
|
-
* @param description 日程描述
|
|
834
|
-
* @param start_timestamp 日程开始时间戳
|
|
835
|
-
* @param end_timestamp 日程结束时间戳
|
|
836
|
-
* @param jump_channel_id 日程开始时跳转的子频道id
|
|
837
|
-
* @param remind_type 日程提醒类型
|
|
838
|
-
* 0 不提醒
|
|
839
|
-
* 1 开始时提醒
|
|
840
|
-
* 2 开始前 5 分钟提醒
|
|
841
|
-
* 3 开始前 15 分钟提醒
|
|
842
|
-
* 4 开始前 30 分钟提醒
|
|
843
|
-
* 5 开始前 60 分钟提醒
|
|
844
|
-
* @returns 返回 Schedule 对象(详见https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/schedule/model.html#schedule)
|
|
845
|
-
*/
|
|
846
|
-
async channelsSchedulesPost(channel_id, data) {
|
|
421
|
+
});
|
|
422
|
+
}
|
|
423
|
+
channelsSchedulesPost(channel_id, data) {
|
|
847
424
|
return this.guildServer({
|
|
848
425
|
method: 'POST',
|
|
849
426
|
url: `/channels/${channel_id}/schedules`,
|
|
850
427
|
data
|
|
851
|
-
})
|
|
852
|
-
}
|
|
853
|
-
|
|
854
|
-
* 修改频道日程
|
|
855
|
-
* @param channel_id 子频道id
|
|
856
|
-
* @param schedule_id 日程id
|
|
857
|
-
* @param name 日程名称
|
|
858
|
-
* @param description 日程描述
|
|
859
|
-
* @param start_timestamp 日程开始时间戳
|
|
860
|
-
* @param end_timestamp 日程结束时间戳
|
|
861
|
-
* @param jump_channel_id 日程开始时跳转的子频道id
|
|
862
|
-
* @param remind_type 日程提醒类型
|
|
863
|
-
* 0 不提醒
|
|
864
|
-
* 1 开始时提醒
|
|
865
|
-
* 2 开始前 5 分钟提醒
|
|
866
|
-
* 3 开始前 15 分钟提醒
|
|
867
|
-
* 4 开始前 30 分钟提醒
|
|
868
|
-
* 5 开始前 60 分钟提醒
|
|
869
|
-
* @returns 返回 Schedule 对象(详见https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/schedule/model.html#schedule)
|
|
870
|
-
*/
|
|
871
|
-
async channelsSchedulesSchedulePatch(channel_id, schedule_id, data) {
|
|
428
|
+
});
|
|
429
|
+
}
|
|
430
|
+
channelsSchedulesSchedulePatch(channel_id, schedule_id, data) {
|
|
872
431
|
return this.guildServer({
|
|
873
432
|
method: 'PATCH',
|
|
874
433
|
url: `/channels/${channel_id}/schedules/${schedule_id}`,
|
|
875
434
|
data
|
|
876
|
-
})
|
|
877
|
-
}
|
|
878
|
-
|
|
879
|
-
* 删除频道日程
|
|
880
|
-
* @param channel_id 子频道id
|
|
881
|
-
* @param schedule_id 日程id
|
|
882
|
-
* @returns
|
|
883
|
-
*/
|
|
884
|
-
async channelsSchedulesScheduleDelete(channel_id, schedule_id) {
|
|
435
|
+
});
|
|
436
|
+
}
|
|
437
|
+
channelsSchedulesScheduleDelete(channel_id, schedule_id) {
|
|
885
438
|
return this.guildServer({
|
|
886
439
|
method: 'DELETE',
|
|
887
440
|
url: `/channels/${channel_id}/schedules/${schedule_id}`
|
|
888
|
-
})
|
|
889
|
-
}
|
|
890
|
-
|
|
891
|
-
* ***********
|
|
892
|
-
* 表情表态api
|
|
893
|
-
* ***********
|
|
894
|
-
*/
|
|
895
|
-
/**
|
|
896
|
-
* 机器人发表表情表态
|
|
897
|
-
* @param channel_id 子频道id
|
|
898
|
-
* @param message_id 消息id
|
|
899
|
-
* @param type 表情类型 1:系统表情 2:emoji表情
|
|
900
|
-
* @param id 表情id 参考https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#Emoji%20%E5%88%97%E8%A1%A8
|
|
901
|
-
* @returns
|
|
902
|
-
*/
|
|
903
|
-
async channelsMessagesReactionsPut(channel_id, message_id, type, id) {
|
|
441
|
+
});
|
|
442
|
+
}
|
|
443
|
+
channelsMessagesReactionsPut(channel_id, message_id, type, id) {
|
|
904
444
|
return this.guildServer({
|
|
905
445
|
method: 'PUT',
|
|
906
446
|
url: `/channels/${channel_id}/messages/${message_id}/reactions/${type}/${id}`
|
|
907
|
-
})
|
|
908
|
-
}
|
|
909
|
-
|
|
910
|
-
* 删除机器人发表的表情表态
|
|
911
|
-
* @param channel_id 子频道id
|
|
912
|
-
* @param message_id 消息id
|
|
913
|
-
* @param type 表情类型 1:系统表情 2:emoji表情
|
|
914
|
-
* @param id 表情id 参考https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#Emoji%20%E5%88%97%E8%A1%A8
|
|
915
|
-
* @returns
|
|
916
|
-
*/
|
|
917
|
-
async channelsMessagesReactionsDelete(channel_id, message_id, type, id) {
|
|
447
|
+
});
|
|
448
|
+
}
|
|
449
|
+
channelsMessagesReactionsDelete(channel_id, message_id, type, id) {
|
|
918
450
|
return this.guildServer({
|
|
919
451
|
method: 'DELETE',
|
|
920
452
|
url: `/channels/${channel_id}/messages/${message_id}/reactions/${type}/${id}`
|
|
921
|
-
})
|
|
922
|
-
}
|
|
923
|
-
|
|
924
|
-
* 获取消息表情表态的用户列表
|
|
925
|
-
* @param channel_id 子频道id
|
|
926
|
-
* @param message_id 消息id
|
|
927
|
-
* @param type 表情类型 1:系统表情 2:emoji表情
|
|
928
|
-
* @param id 表情id 参考https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#Emoji%20%E5%88%97%E8%A1%A8
|
|
929
|
-
* @param {object} data
|
|
930
|
-
* @param {object} data.cookie 返回的cookie 第一次请求不传,后续请求传上次返回的cookie
|
|
931
|
-
* @param {object} data.limit 返回的用户数量 默认20 最大50
|
|
932
|
-
* @returns data:{ users:User[], cookie:string,is_end:true|false }
|
|
933
|
-
*/
|
|
934
|
-
async channelsMessagesReactionsUsers(channel_id, message_id, type, id, data) {
|
|
453
|
+
});
|
|
454
|
+
}
|
|
455
|
+
channelsMessagesReactionsUsers(channel_id, message_id, type, id, data) {
|
|
935
456
|
return this.guildServer({
|
|
936
457
|
method: 'GET',
|
|
937
458
|
url: `/channels/${channel_id}/messages/${message_id}/reactions/${type}/${id}`,
|
|
938
459
|
data
|
|
939
|
-
})
|
|
940
|
-
}
|
|
941
|
-
|
|
942
|
-
* ***********
|
|
943
|
-
* 音频api
|
|
944
|
-
* 音频接口:仅限音频类机器人才能使用,后续会根据机器人类型自动开通接口权限,现如需调用,需联系平台申请权限
|
|
945
|
-
* **********
|
|
946
|
-
*/
|
|
947
|
-
/**
|
|
948
|
-
* 音频控制
|
|
949
|
-
* @param channel_id 子频道id
|
|
950
|
-
* @param audio_url 音频url status为0时传
|
|
951
|
-
* @param status 0:开始 1:暂停 2:继续 3:停止
|
|
952
|
-
* @param text 状态文本(比如:简单爱-周杰伦),可选,status为0时传,其他操作不传
|
|
953
|
-
* @returns
|
|
954
|
-
*/
|
|
955
|
-
async channelsAudioPost(channel_id, data) {
|
|
460
|
+
});
|
|
461
|
+
}
|
|
462
|
+
channelsAudioPost(channel_id, data) {
|
|
956
463
|
return this.guildServer({
|
|
957
464
|
method: 'POST',
|
|
958
465
|
url: `/channels/${channel_id}/audio`,
|
|
959
466
|
data
|
|
960
|
-
})
|
|
961
|
-
}
|
|
962
|
-
|
|
963
|
-
* 机器人上麦
|
|
964
|
-
* @param channel_id 语音子频道id
|
|
965
|
-
* @returns {}
|
|
966
|
-
*/
|
|
967
|
-
async channelsMicPut(channel_id) {
|
|
467
|
+
});
|
|
468
|
+
}
|
|
469
|
+
channelsMicPut(channel_id) {
|
|
968
470
|
return this.guildServer({
|
|
969
471
|
method: 'PUT',
|
|
970
472
|
url: `/channels/${channel_id}/mic`
|
|
971
|
-
})
|
|
972
|
-
}
|
|
973
|
-
|
|
974
|
-
* 机器人下麦
|
|
975
|
-
* @param channel_id 语音子频道id
|
|
976
|
-
* @returns {}
|
|
977
|
-
*/
|
|
978
|
-
async channelsMicDelete(channel_id) {
|
|
473
|
+
});
|
|
474
|
+
}
|
|
475
|
+
channelsMicDelete(channel_id) {
|
|
979
476
|
return this.guildServer({
|
|
980
477
|
method: 'DELETE',
|
|
981
478
|
url: `/channels/${channel_id}/mic`
|
|
982
|
-
})
|
|
983
|
-
}
|
|
984
|
-
|
|
985
|
-
* **********
|
|
986
|
-
* 帖子api
|
|
987
|
-
* 注意
|
|
988
|
-
* 公域机器人暂不支持申请,仅私域机器人可用,选择私域机器人后默认开通。
|
|
989
|
-
* 注意: 开通后需要先将机器人从频道移除,然后重新添加,方可生效。
|
|
990
|
-
* **********
|
|
991
|
-
*/
|
|
992
|
-
/**
|
|
993
|
-
* 获取帖子列表
|
|
994
|
-
* @param channel_id 子频道id
|
|
995
|
-
* @returns {threads:Thread[],is_finish:0|1}
|
|
996
|
-
* @returns 返回 Thread 对象数组(详见https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/forum/model.html#Thread)
|
|
997
|
-
* @returns is_finish 为 1 时,表示已拉取完 为 0 时,表示未拉取完
|
|
998
|
-
*/
|
|
999
|
-
async channelsThreads(channel_id) {
|
|
479
|
+
});
|
|
480
|
+
}
|
|
481
|
+
channelsThreads(channel_id) {
|
|
1000
482
|
return this.guildServer({
|
|
1001
483
|
method: 'GET',
|
|
1002
484
|
url: `/channels/${channel_id}/threads`
|
|
1003
|
-
})
|
|
1004
|
-
}
|
|
1005
|
-
|
|
1006
|
-
* 获取帖子详情
|
|
1007
|
-
* @param channel_id 子频道id
|
|
1008
|
-
* @param thread_id 帖子id
|
|
1009
|
-
* @returns 返回 帖子详情对象(详见https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/forum/model.html#ThreadInfo)
|
|
1010
|
-
* 其中content字段可参考 https://bot.q.qq.com/wiki/develop/api-v2/server-inter/channel/content/forum/model.html#RichText
|
|
1011
|
-
*/
|
|
1012
|
-
async channelsThreadsThread(channel_id, thread_id) {
|
|
485
|
+
});
|
|
486
|
+
}
|
|
487
|
+
channelsThreadsThread(channel_id, thread_id) {
|
|
1013
488
|
return this.guildServer({
|
|
1014
489
|
method: 'GET',
|
|
1015
490
|
url: `/channels/${channel_id}/threads/${thread_id}`
|
|
1016
|
-
})
|
|
1017
|
-
}
|
|
1018
|
-
|
|
1019
|
-
* 发表帖子
|
|
1020
|
-
* @param channel_id 子频道id
|
|
1021
|
-
* @param title 帖子标题
|
|
1022
|
-
* @param content 帖子内容
|
|
1023
|
-
* @param format 帖子内容格式 1:纯文本 2:HTML 3:Markdown 4:JSON
|
|
1024
|
-
* @returns 返回 {task_id:string,create_time:string} 其中 task_id 为帖子id,create_time 发帖时间戳
|
|
1025
|
-
*/
|
|
1026
|
-
async channelsThreadsPut(channel_id, data) {
|
|
491
|
+
});
|
|
492
|
+
}
|
|
493
|
+
channelsThreadsPut(channel_id, data) {
|
|
1027
494
|
return this.guildServer({
|
|
1028
495
|
method: 'PUT',
|
|
1029
496
|
url: `/channels/${channel_id}/threads`,
|
|
1030
497
|
data
|
|
1031
|
-
})
|
|
1032
|
-
}
|
|
1033
|
-
|
|
1034
|
-
* 删除帖子
|
|
1035
|
-
* @param channel_id 子频道id
|
|
1036
|
-
* @param thread_id 帖子id
|
|
1037
|
-
* @returns
|
|
1038
|
-
*/
|
|
1039
|
-
async channelsThreadsDelete(channel_id, thread_id) {
|
|
498
|
+
});
|
|
499
|
+
}
|
|
500
|
+
channelsThreadsDelete(channel_id, thread_id) {
|
|
1040
501
|
return this.guildServer({
|
|
1041
502
|
method: 'DELETE',
|
|
1042
503
|
url: `/channels/${channel_id}/threads/${thread_id}`
|
|
1043
|
-
})
|
|
1044
|
-
}
|
|
1045
|
-
|
|
1046
|
-
* ********
|
|
1047
|
-
* 接口权限api
|
|
1048
|
-
* **********
|
|
1049
|
-
*/
|
|
1050
|
-
/**
|
|
1051
|
-
* 获得频道可用权限列表
|
|
1052
|
-
* @param guild_id
|
|
1053
|
-
* @returns
|
|
1054
|
-
*/
|
|
1055
|
-
async guildApiPermission(guild_id) {
|
|
504
|
+
});
|
|
505
|
+
}
|
|
506
|
+
guildApiPermission(guild_id) {
|
|
1056
507
|
return this.guildServer({
|
|
1057
508
|
url: `/guilds/${guild_id}/api_permission`
|
|
1058
|
-
})
|
|
1059
|
-
}
|
|
1060
|
-
|
|
1061
|
-
|
|
1062
|
-
|
|
1063
|
-
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
|
|
1068
|
-
return this.groupService({
|
|
1069
|
-
method: 'PUT',
|
|
1070
|
-
url: `/interactions/${interaction_id}`,
|
|
1071
|
-
data: {
|
|
1072
|
-
code: code || 0
|
|
1073
|
-
}
|
|
1074
|
-
}).then(res => res?.data);
|
|
1075
|
-
}
|
|
1076
|
-
else {
|
|
1077
|
-
return this.guildServer({
|
|
1078
|
-
method: 'PUT',
|
|
1079
|
-
url: `/interactions/${interaction_id}`,
|
|
1080
|
-
data: {
|
|
1081
|
-
code: code || 0
|
|
1082
|
-
}
|
|
1083
|
-
}).then(res => res?.data);
|
|
1084
|
-
}
|
|
509
|
+
});
|
|
510
|
+
}
|
|
511
|
+
interactionResponse(_mode, interaction_id, code) {
|
|
512
|
+
return this.groupService({
|
|
513
|
+
method: 'PUT',
|
|
514
|
+
url: `/interactions/${interaction_id}`,
|
|
515
|
+
data: {
|
|
516
|
+
code: code || 0
|
|
517
|
+
}
|
|
518
|
+
});
|
|
1085
519
|
}
|
|
1086
520
|
}
|
|
1087
521
|
|