Skip to content

Commit f2776c2

Browse files
committed
Update group-tag.md
1 parent 6de31fd commit f2776c2

1 file changed

Lines changed: 83 additions & 0 deletions

File tree

src/api/v1/group-tag.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -195,3 +195,86 @@ POST /v1/group-tag/delete
195195
"msg": "success" // 返回状态消息
196196
}
197197
```
198+
199+
## 获取标签绑定的用户列表
200+
201+
POST /v1/group-tag/members
202+
203+
请求头:
204+
205+
|名称|必须|备注|
206+
|---|---|---|
207+
|token|||
208+
209+
请求体:
210+
211+
```ProtoBuf
212+
data {
213+
size: 50 // 分页大小
214+
page: 1 // 页数
215+
}
216+
group_id: "123" // 群聊ID
217+
tag_id: 123 // 标签ID
218+
```
219+
220+
::: details ProtoBuf数据结构
221+
222+
```proto
223+
message tag_member_send {
224+
Data data = 2;
225+
message Data {
226+
int32 size = 1; // 分页大小
227+
int32 page = 2; // 页数
228+
}
229+
string group_id = 3; // 标签所处群聊ID
230+
int64 tag_id = 4; // 标签ID
231+
}
232+
```
233+
234+
:::
235+
236+
响应体:
237+
238+
```ProtoBuf
239+
status {
240+
number: 114514
241+
code: 1
242+
msg: "success"
243+
}
244+
user {
245+
group_id: "big" // 所属群聊ID
246+
user_info {
247+
user_id: "7356666" // 用户ID
248+
name: "Feng" // 用户名
249+
avatar_url: "https://..." // 头像URL
250+
}
251+
total: 1 // 总数
252+
```
253+
254+
::: details ProtoBuf数据结构
255+
256+
```proto
257+
// 标签绑定的用户列表
258+
message tag_member {
259+
Status status = 1;
260+
repeated User user = 2;
261+
message User {
262+
string group_id = 1;
263+
User_info user_info = 2;
264+
265+
message User_info {
266+
string user_id = 1;
267+
string name = 2;
268+
string avatar_url = 4;
269+
int32 is_vip = 6;
270+
}
271+
272+
int32 permission_level = 3;
273+
int64 gag_time = 4; // 禁言时间
274+
int32 is_gag = 5; // 是否被禁言
275+
}
276+
int64 total = 3; // 总数
277+
}
278+
```
279+
280+
:::

0 commit comments

Comments
 (0)