import type { AuthToken } from "./token"; import type { NetRequestFactory, RequestInternalError } from "@seayoo-web/request"; /** * 鹅鸭杀(ggd)定制化 public 接口,如果需要调用需要登录态的接口,初始化需要传入 AuthToken */ export declare class GGDPublicApi { req: ReturnType | null; constructor(authToken: AuthToken); constructor(endpoint: string, NetRequest: NetRequestFactory); /** * 获取鹅鸭杀房间内详情 * * 💡不需要登录 * * - 参数 `invitationCode` 默认从 url query 的 `invitation_code` 参数读取 * - 参数 `serverId` 默认从 url query 的 `server_id` 参数读取 * - 参数 `expiresAt` 默认从 url query 的 `expires_at` 参数读取 * * 接口文档 https://www.kdocs.cn/l/cf2mO2uRLqh9?linkname=vpkahwYfte * * 响应依据 GM 协议 https://www.kdocs.cn/l/cnZbBuB5x12C?linkname=pRQPKz6vUa */ describeRoomByCode(invitationCode?: string, serverId?: number | string, expiresAt?: number | string): Promise<{ room_id: string; inviter_role_id: number; room_status: import("./ggd.enums").GGDRoomStatus; room_mode: string | undefined; room_tags: string[] | undefined; max_members: number | undefined; members: { role_id: /*elided*/ any; role_name: /*elided*/ any; avatar_url: /*elided*/ any; }[] | undefined; } | { error: RequestInternalError | "room_not_found" | "invitation_code_invalid" | "invitation_code_expired"; message: string; }>; /** * 查询当前登录用户的游戏角色信息,包括角色编号、昵称、等级、行为分、领头鹅等级、头像、创角时间等 * * 💡需要登录 * * https://www.kdocs.cn/l/ccZPz3rWSl4o?linkname=NtItEHncF8 */ describeRole(): Promise<{ combo_id: string; showid: number | undefined; role_id: string | number; role_name: string; role_level: number | undefined; avatar_url: string | undefined; behavior_score: number | undefined; lead_goose_level: number | undefined; create_time: number; } | { error: "role_not_found" | RequestInternalError; message: string; }>; /** * 查询当前登录用户的对局统计数据,包括推理等级、巅峰数、各阵营胜率/胜场、击杀、票准率等 * * 💡需要登录 * * https://www.kdocs.cn/l/ccZPz3rWSl4o?linkname=CntoE573fE * * [GM 命令 DescribeRoleMatchStats](https://www.kdocs.cn/l/cnZbBuB5x12C?linkname=mhjVTRxSVD) */ describeRoleMatchStats(roleId: number): Promise<{ inference_level: string | undefined; recent_classic_survival_round: number | undefined; recent_goose_vote_correct_rate: string | undefined; recent_duck_vote_correct_rate: string | undefined; recent_total_killed_count: number | undefined; season_top_count: number | undefined; goose_win_rate: string | undefined; duck_win_rate: string | undefined; neutral_win_rate: string | undefined; goose_win_count: number | undefined; duck_win_count: number | undefined; neutral_win_count: number | undefined; total_win_rate: string | undefined; total_count: number | undefined; goose_vote_correct_rate: string | undefined; duck_vote_correct_rate: string | undefined; total_killed_count: number | undefined; } | { error: "role_not_found" | RequestInternalError; message: string; }>; /** * 查询当前登录用户的对局记录,返回近 30 天的对局记录,最多 50 场。 * * 除展示对局列表外,本接口返回条数同时作为「近 30 天总场次」的数据来源,修改返回上限或时间窗口时需同步评估影响 * * 💡需要登录 * * https://www.kdocs.cn/l/ccZPz3rWSl4o?linkname=NSvUAib1FA * * [GM 命令 ListRoleMatches](https://www.kdocs.cn/l/cnZbBuB5x12C?linkname=ftJhlIPOX2) */ listRoleMatches(roleId: number): Promise<{ players_num: number; end_time: number; map_name: string; career_camp: import("./ggd.enums").GGDCareerCampType; player_status: import("./ggd.enums").GGDPlayerStatus; career_name: string; mode_name: string; }[] | { error: "role_not_found" | RequestInternalError; message: string; } | undefined>; }