QQBotHttpClient

底层 HTTP API 客户端，封装了所有 QQ Bot REST API 调用。

命名空间: Luolan.QQBot.Services

通过 bot.Api 访问实例。

基础请求方法

Task<T> GetAsync<T>(string endpoint, CancellationToken ct = default)
Task<T> PostAsync<T>(string endpoint, object? body = null, CancellationToken ct = default)
Task PostAsync(string endpoint, object? body = null, CancellationToken ct = default)
Task<T> PutAsync<T>(string endpoint, object? body = null, CancellationToken ct = default)
Task PutAsync(string endpoint, object? body = null, CancellationToken ct = default)
Task<T> PatchAsync<T>(string endpoint, object? body = null, CancellationToken ct = default)
Task DeleteAsync(string endpoint, CancellationToken ct = default)

用户 API

Task<BotInfo> GetCurrentUserAsync()
Task<List<Guild>> GetCurrentUserGuildsAsync()

频道 API

Task<Guild> GetGuildAsync(string guildId)

子频道 API

Task<List<Channel>> GetChannelsAsync(string guildId)
Task<Channel> GetChannelAsync(string channelId)
Task<Channel> CreateChannelAsync(string guildId, object channelInfo)
Task<Channel> ModifyChannelAsync(string channelId, object channelInfo)
Task DeleteChannelAsync(string channelId)

成员 API

Task<List<Member>> GetGuildMembersAsync(string guildId, string? after = null, int limit = 100)
Task<Member> GetGuildMemberAsync(string guildId, string userId)
Task DeleteGuildMemberAsync(string guildId, string userId, bool addBlacklist = false, int deleteHistoryMsgDays = 0)

角色 API

Task<GetGuildRolesResponse> GetGuildRolesAsync(string guildId)
Task<CreateRoleResponse> CreateGuildRoleAsync(string guildId, CreateRoleRequest request)
Task<CreateRoleResponse> ModifyGuildRoleAsync(string guildId, string roleId, CreateRoleRequest request)
Task DeleteGuildRoleAsync(string guildId, string roleId)
Task AddMemberToRoleAsync(string guildId, string userId, string roleId, string? channelId = null)
Task RemoveMemberFromRoleAsync(string guildId, string userId, string roleId, string? channelId = null)

子频道权限 API

Task<ChannelPermissions> GetChannelPermissionsAsync(string channelId, string userId)
Task ModifyChannelPermissionsAsync(string channelId, string userId, UpdateChannelPermissionsRequest request)
Task<ChannelPermissions> GetChannelRolePermissionsAsync(string channelId, string roleId)
Task ModifyChannelRolePermissionsAsync(string channelId, string roleId, UpdateChannelPermissionsRequest request)

消息 API

Task<Message> GetMessageAsync(string channelId, string messageId)
Task<Message> SendMessageAsync(string channelId, SendMessageRequest request)
Task<Message> SendTextMessageAsync(string channelId, string content, string? msgId = null)
Task DeleteMessageAsync(string channelId, string messageId, bool hideTip = false)

私信 API

Task<DirectMessageSession> CreateDmsAsync(CreateDmsRequest request)
Task<Message> SendDmsAsync(string guildId, SendMessageRequest request)
Task DeleteDmsAsync(string guildId, string messageId, bool hideTip = false)

群消息 API

Task<SendGroupMessageResponse> SendGroupMessageAsync(string groupOpenId, SendGroupMessageRequest request)
Task<SendGroupMessageResponse> SendGroupTextMessageAsync(string groupOpenId, string content, string? msgId = null, int msgSeq = 0)
Task DeleteGroupMessageAsync(string groupOpenId, string messageId)
Task<UploadMediaResponse> UploadGroupMediaAsync(string groupOpenId, UploadMediaRequest request)
Task<UploadPrepareResponse> PrepareGroupMediaUploadAsync(string groupOpenId, UploadPrepareRequest request)
Task FinishGroupMediaUploadPartAsync(string groupOpenId, UploadPartFinishRequest request)

C2C 消息 API

Task<SendGroupMessageResponse> SendC2CMessageAsync(string openId, SendGroupMessageRequest request)
Task<SendGroupMessageResponse> SendC2CTextMessageAsync(string openId, string content, string? msgId = null, int msgSeq = 0)
Task<StreamMessageResponse> SendC2CStreamMessageAsync(string userOpenId, SendC2CStreamMessageRequest request)
Task<SendGroupMessageResponse> SendC2CInputNotifyAsync(string userOpenId, string? msgId = null, int inputSecond = 60, int msgSeq = 1)
Task DeleteC2CMessageAsync(string userOpenId, string messageId)
Task<UploadMediaResponse> UploadC2CMediaAsync(string userOpenId, UploadMediaRequest request)
Task<UploadPrepareResponse> PrepareC2CMediaUploadAsync(string userOpenId, UploadPrepareRequest request)
Task FinishC2CMediaUploadPartAsync(string userOpenId, UploadPartFinishRequest request)

群管理 API

// 群信息
Task<GroupInfo> GetGroupInfoAsync(string groupOpenId)
Task<GroupBotState> GetGroupBotStateAsync(string groupOpenId)

// 群成员
Task<GroupMemberListResponse> GetGroupMembersAsync(string groupOpenId, string? cursor = null)
Task<GroupMember> GetGroupMemberAsync(string groupOpenId, string memberOpenId)
Task<BatchRemoveMembersResponse> BatchRemoveGroupMembersAsync(string groupOpenId, BatchRemoveMembersRequest request)

// 入群申请
Task<JoinRequestListResponse> GetGroupJoinRequestsAsync(string groupOpenId, string? cursor = null, int limit = 20)
Task ApproveGroupJoinRequestAsync(string groupOpenId, string memberOpenId, ApproveJoinRequestRequest request)

// 入群自动审批策略
Task<JoinApprovalStrategyListResponse> GetJoinApprovalStrategiesAsync(string? cursor = null, int limit = 20)
Task<JoinApprovalStrategyResponse> CreateJoinApprovalStrategyAsync(CreateJoinApprovalStrategyRequest request)
Task<UpdateJoinApprovalStrategyResponse> UpdateJoinApprovalStrategyAsync(string strategyId, UpdateJoinApprovalStrategyRequest request)
Task DeleteJoinApprovalStrategyAsync(string strategyId)
Task ExecuteJoinApprovalStrategyAsync(string strategyId)
Task<UpdateWhitelistUsersResponse> UpdateJoinApprovalWhitelistAsync(string strategyId, UpdateWhitelistUsersRequest request)

// 黑名单
Task<GroupBlacklistResponse> GetGroupBlacklistAsync(string groupOpenId, string? cursor = null, int limit = 20)
Task<GroupBlacklistOperationResponse> UpdateGroupBlacklistAsync(string groupOpenId, GroupBlacklistRequest request)

// 禁言
Task<GroupRestrictChatSetting> GetGroupRestrictChatSettingAsync(string groupOpenId)
Task SetGroupMemberMuteAsync(string groupOpenId, SetGroupMemberMuteRequest request)

互动 API

// 自定义菜单（仅 C2C）
Task<MenuResponse> GetMenuAsync()
Task<MenuResponse> UpdateMenuAsync(QQBotMenu menu)

// 指令面板
Task<PanelListResponse> GetPanelsAsync(string scope, string? cursor = null, int limit = 20)
Task<PanelRecord> GetPanelAsync(string panelId)
Task<CreatePanelResponse> CreatePanelAsync(CreatePanelRequest request)
Task<PanelVersionResponse> UpdatePanelAsync(string panelId, Panel panel)
Task UpdatePanelTargetAsync(string panelId, UpdatePanelTargetRequest request)
Task DeletePanelAsync(string panelId)

// 互动回调响应
Task RespondInteractionAsync(string interactionId, int code = 0)

// 生成分享链接
Task<GenerateUrlLinkResponse> GenerateUrlLinkAsync(string? callbackData = null)

表情表态 API

Task AddReactionAsync(string channelId, string messageId, string emojiType, string emojiId)
Task DeleteReactionAsync(string channelId, string messageId, string emojiType, string emojiId)

精华消息 API

Task<PinsMessage> AddPinsMessageAsync(string channelId, string messageId)
Task DeletePinsMessageAsync(string channelId, string messageId)
Task<PinsMessage> GetPinsMessageAsync(string channelId)

日程 API

Task<List<Schedule>> GetSchedulesAsync(string channelId, string? since = null)
Task<Schedule> GetScheduleAsync(string channelId, string scheduleId)
Task<Schedule> CreateScheduleAsync(string channelId, Schedule schedule)
Task<Schedule> ModifyScheduleAsync(string channelId, string scheduleId, Schedule schedule)
Task DeleteScheduleAsync(string channelId, string scheduleId)

禁言 API

Task MuteGuildAsync(string guildId, int muteSeconds = 0, string? muteEndTimestamp = null)
Task MuteMemberAsync(string guildId, string userId, int muteSeconds = 0, string? muteEndTimestamp = null)
Task MuteMembersAsync(string guildId, IEnumerable<string> userIds, int muteSeconds = 0, string? muteEndTimestamp = null)

公告 API

Task<Announces> CreateAnnouncesAsync(string guildId, string channelId, string messageId)
Task DeleteAnnouncesAsync(string guildId, string messageId = "all")

网关 API

Task<GatewayInfo> GetGatewayAsync()
Task<GatewayBotInfo> GetGatewayBotAsync()

异常

public class QQBotApiException : Exception
{
    public int Code { get; }        // API 错误码
    public string? TraceId { get; } // 追踪 ID
}

TokenManager

// 通过 bot.TokenManager 访问
Task<string> GetAccessTokenAsync(CancellationToken ct = default)
Task<string> GetAuthorizationHeaderAsync(CancellationToken ct = default)
Task<string> RefreshTokenAsync(CancellationToken ct = default)