qqpd-bot-java/src/main/java/io/github/kloping/qqbot/http/GuildBase.java at master · Kloping/qqpd-bot-java · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
package io.github.kloping.qqbot.http;

import io.github.kloping.qqbot.Starter;
import io.github.kloping.qqbot.entities.ex.ChannelData;
import io.github.kloping.qqbot.entities.qqpd.Channel;
import io.github.kloping.qqbot.entities.qqpd.Guild;
import io.github.kloping.qqbot.entities.qqpd.Member;
import io.github.kloping.qqbot.entities.qqpd.Roles;
import io.github.kloping.spt.annotations.http.*;

import java.util.Map;

/**
 * @author github.kloping
 */
@HttpClient(Starter.NET_POINT)
@Headers("io.github.kloping.qqbot.Start0.getHeaders")
public interface GuildBase {
    /**
     * get guilds
     *
     * @return
     */
    @GetPath("/users/@me/guilds")
    Guild[] getGuilds();

    /**
     * get a guild
     *
     * @param gid
     * @return
     */
    @GetPath("/guilds/{gid}")
    Guild getGuild(@PathValue("gid") String gid);

    /**
     * get channels
     *
     * @param gid
     * @return
     */
    @GetPath("/guilds/{gid}/channels")
    Channel[] getChannels(@PathValue("gid") String gid);

    /**
     * get members
     *
     * @param gid
     * @param num
     * @return
     */
    @GetPath("/guilds/{guild_id}/members")
    Member[] getMembers(@PathValue("guild_id") String gid, @ParamName("limit") Integer num);

    /**
     * get member
     *
     * @param gid
     * @param userId
     * @return
     */
    @GetPath("/guilds/{guild_id}/members/{user_id}")
    Member getMember(@PathValue("guild_id") String gid, @PathValue("user_id") String userId);

    /**
     * get roles
     *
     * @param gid
     * @return
     */
    @GetPath("/guilds/{guild_id}/roles")
    Roles getRoles(@PathValue("guild_id") String gid);

    /**
     * 创建一个子频道
     *
     * @param headers
     * @param gid
     * @param data
     * @return
     */
    @PostPath("/guilds/{guild_id}/channels")
    Channel create(@Headers Map<String, String> headers, @PathValue("guild_id") String gid, @RequestBody(type = io.github.kloping.spt.annotations.http.RequestBody.type.json) ChannelData data);
}