{"openapi":"3.0.3","info":{"title":"OAPI","description":"","license":{"name":""},"version":"1.1.0"},"paths":{"/api/admin/badges/award":{"post":{"tags":["badges"],"operationId":"award","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardRequest"}}},"required":true},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardResult"}}}},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Admin required"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Attribution failed"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/admin/badges/discord/{user}/evaluate":{"post":{"tags":["badges"],"operationId":"evaluate_discord","parameters":[{"name":"user","in":"path","description":"PocketBase Discord user record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AwardResult"}}}}},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Admin required"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Evaluation failed"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/admin/badges/players/{player}/evaluate":{"post":{"tags":["badges"],"operationId":"evaluate","parameters":[{"name":"player","in":"path","description":"PocketBase player record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AwardResult"}}}}},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Admin required"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Evaluation failed"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/admin/discord/stats":{"get":{"tags":["Discord"],"operationId":"global","responses":{"200":{"description":"All-time global totals and complete statistics per player; Admin auth_token session required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalDiscordActivity"}}}},"401":{"description":"Authentication required"},"403":{"description":"Admin required"},"429":{"description":"Route quota exceeded (10 requests per minute); Retry-After in seconds"},"503":{"description":"Statistics unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/admin/users":{"get":{"tags":["admin"],"summary":"Admin endpoint to retrieve all Discord users stored in PocketBase.","description":"Requires the `Admin` role via `require_admin` middleware.","operationId":"get_all_users","responses":{"200":{"description":"List of all Discord users","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DiscordUser"}}}}},"403":{"description":"Forbidden"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"500":{"description":"Internal server error"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/auth/callback":{"get":{"tags":["auth"],"operationId":"callback","parameters":[{"name":"code","in":"query","description":"OAuth2 authorization code","required":false,"schema":{"type":"string","nullable":true}},{"name":"state","in":"query","description":"Signed OAuth state bound to the browser cookie","required":true,"schema":{"type":"string"}}],"responses":{"303":{"description":"Redirects to frontend after authentication"},"400":{"description":"Missing, unbound, expired or invalid OAuth state or code"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}}}},"/api/auth/login":{"get":{"tags":["auth"],"operationId":"login","parameters":[{"name":"return_to","in":"query","description":"Optional URL to redirect to after successful login","required":false,"schema":{"type":"string","nullable":true}}],"responses":{"303":{"description":"Redirects to Discord OAuth2 login page"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"503":{"description":"Authentication configuration unavailable"}}}},"/api/auth/logout":{"get":{"tags":["auth"],"operationId":"logout","parameters":[{"name":"return_to","in":"query","description":"Optional URL to redirect to after logout","required":false,"schema":{"type":"string","nullable":true}}],"responses":{"303":{"description":"Clears the auth_token cookie and redirects to home or return_to"},"403":{"description":"Not a top-level navigation (embedded or scripted request)"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}}}},"/api/auth/me":{"get":{"tags":["auth"],"operationId":"me","responses":{"200":{"description":"Returns the current user status"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}},"security":[{"session_cookie":[]}]}},"/api/auth/rom/code":{"post":{"tags":["ROM"],"operationId":"create_code","parameters":[{"name":"label","in":"query","description":"Device name (trimmed, max 32 characters)","required":false,"schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RomCodeResponse"}}}},"401":{"description":"Authentication required"},"403":{"description":"Service tokens cannot link a ROM or cross-origin request"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"ROM link unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/auth/rom/devices":{"get":{"tags":["ROM"],"operationId":"devices","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RomDeviceList"}}}},"401":{"description":"Authentication required"},"403":{"description":"Service tokens have no devices"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"ROM link unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/auth/rom/devices/{device}/revoke":{"post":{"tags":["ROM"],"operationId":"revoke","parameters":[{"name":"device","in":"path","description":"PocketBase discord_identity_token record ID","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Device revoked"},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Cross-origin request or service token"},"404":{"description":"Device not found"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"ROM link unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/auth/rom/token":{"post":{"tags":["ROM"],"operationId":"exchange","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RomTokenRequest"}}},"required":true},"responses":{"200":{"description":"Token shown once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RomTokenResponse"}}}},"400":{"description":"Invalid code"},"404":{"description":"Unknown or expired code"},"429":{"description":"Too many failed exchanges across all callers, see Retry-After"},"502":{"description":"ROM link unavailable"}}}},"/api/auth/site/login":{"get":{"tags":["auth"],"operationId":"site_login","parameters":[{"name":"return_to","in":"query","description":"Optional website path (e.g. /classements/discord) to go back to after login","required":false,"schema":{"type":"string","nullable":true}},{"name":"origin","in":"query","description":"Optional website origin (site_auth.url or site_auth.extra_urls); defaults to site_auth.url","required":false,"schema":{"type":"string","nullable":true}}],"responses":{"303":{"description":"Redirects to Discord OAuth2 login page, then back to the website"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"503":{"description":"Authentication configuration unavailable"}}}},"/api/auth/site/logout":{"get":{"tags":["auth"],"operationId":"site_logout","parameters":[{"name":"return_to","in":"query","description":"Optional website path to go back to after logout","required":false,"schema":{"type":"string","nullable":true}},{"name":"origin","in":"query","description":"Optional website origin (site_auth.url or site_auth.extra_urls); defaults to site_auth.url","required":false,"schema":{"type":"string","nullable":true}}],"responses":{"303":{"description":"Clears the auth_token cookie and redirects to the website"},"403":{"description":"Not a top-level navigation (embedded or scripted request)"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}}}},"/api/auth/site/me":{"get":{"tags":["auth"],"operationId":"site_me","responses":{"200":{"description":"Returns the current user's public Discord profile, readable by the configured website (CORS with credentials)"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}},"security":[{"session_cookie":[]}]}},"/api/badges/discord/{user}/refresh":{"post":{"tags":["badges"],"operationId":"refresh_discord","parameters":[{"name":"user","in":"path","description":"PocketBase Discord user record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/badge_service.RefreshResponse"}}}},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Account belongs to another user"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Refresh failed"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/badges/me/refresh":{"post":{"tags":["badges"],"operationId":"refresh_mine","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/badge_service.RefreshResponse"}}}},"401":{"description":"Authentication required"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Refresh unavailable"}},"security":[{"session_cookie":[]}]}},"/api/badges/players/{player}/refresh":{"post":{"tags":["badges"],"operationId":"refresh_player","parameters":[{"name":"player","in":"path","description":"PocketBase player record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AwardResult"}}}}},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Account belongs to another user"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Refresh failed"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/discord-summary/me":{"post":{"tags":["Discord"],"summary":"Generate the connected user's Discord image without supplying an ID.","operationId":"create_my_discord_summary","responses":{"200":{"description":"Personal image generated; URL requires the owner's or administrator's session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageResponse"}}}},"400":{"description":"Invalid session Discord ID"},"401":{"description":"Authentication required"},"429":{"description":"Route quota exceeded (10 requests per minute); Retry-After in seconds"},"500":{"description":"Image generation unavailable"}},"security":[{"session_cookie":[]}]}},"/api/discord-summary/{id}":{"post":{"tags":["Discord"],"summary":"Generates a Discord summary image for a specific user.","description":"This endpoint fetches user data and statistics from external APIs and\ngenerates a high-fidelity profile summary card as a PNG image.","operationId":"create_discord_summary_by_id","parameters":[{"name":"id","in":"path","description":"Discord Snowflake ID of the user","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Discord summary image generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageResponse"}}}},"400":{"description":"Invalid Discord ID"},"401":{"description":"Authentication required"},"403":{"description":"User belongs to another account"},"429":{"description":"Route quota exceeded (10 requests per minute); Retry-After in seconds"},"500":{"description":"Internal server error"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/discord/stats/me":{"get":{"tags":["Discord"],"operationId":"personal","responses":{"200":{"description":"All-time personal activity; auth_token session cookie required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscordActivity"}}}},"401":{"description":"Authentication required"},"429":{"description":"Route quota exceeded (10 requests per minute); Retry-After in seconds"},"503":{"description":"Statistics unavailable"}},"security":[{"session_cookie":[]}]}},"/api/friends/{account}":{"get":{"tags":["Friends"],"summary":"Lists the account's friendships.","description":"Also accepts `Authorization: Bearer rom_...` (ROM token): read-only, own account only.","operationId":"list","parameters":[{"name":"account","in":"path","description":"`me` (session only) or a PocketBase discord_users record ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FriendList"}}}},"400":{"description":"Invalid ID or service used /me"},"401":{"description":"Authentication required"},"403":{"description":"Account belongs to another user"},"404":{"description":"Account not found"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Friends unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/friends/{account}/{user}/accept":{"post":{"tags":["Friends"],"operationId":"accept","parameters":[{"name":"account","in":"path","description":"`me` (session only) or a PocketBase discord_users record ID","required":true,"schema":{"type":"string"}},{"name":"user","in":"path","description":"PocketBase discord_users record ID of the requester","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FriendshipResponse"}}}},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Account belongs to another user or cross-origin request"},"404":{"description":"No pending request from this user"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Friends unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/friends/{account}/{user}/remove":{"post":{"tags":["Friends"],"operationId":"remove","parameters":[{"name":"account","in":"path","description":"`me` (session only) or a PocketBase discord_users record ID","required":true,"schema":{"type":"string"}},{"name":"user","in":"path","description":"PocketBase discord_users record ID of the other member","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Friend removed, request declined or cancelled"},"400":{"description":"Invalid ID"},"401":{"description":"Authentication required"},"403":{"description":"Account belongs to another user or cross-origin request"},"404":{"description":"No friendship with this user"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Friends unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/friends/{account}/{user}/request":{"post":{"tags":["Friends"],"operationId":"request","parameters":[{"name":"account","in":"path","description":"`me` (session only) or a PocketBase discord_users record ID","required":true,"schema":{"type":"string"}},{"name":"user","in":"path","description":"Exact Discord username/tag (e.g. rerebleue), optionally prefixed with @; never a PocketBase ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Request sent, or accepted when the other member had already asked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FriendshipResponse"}}}},"400":{"description":"Invalid tag or self request"},"401":{"description":"Authentication required"},"403":{"description":"Account belongs to another user or cross-origin request"},"404":{"description":"Discord tag not found"},"409":{"description":"Already friends, request already sent, or ambiguous tag"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"Friends unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/investor/stats":{"get":{"tags":["investor"],"summary":"Investor endpoint to retrieve user statistics.","description":"Requires `LoutreInvesti` or `Admin` role via `require_investor` middleware.","operationId":"get_stats","responses":{"200":{"description":"Current PocketBase record counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/crate.models.investor.InvestorStats"}}}},"401":{"description":"Unauthenticated"},"403":{"description":"Forbidden"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"503":{"description":"Statistics temporarily unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/minecraft-summary/{uuid}":{"post":{"tags":["Minecraft"],"summary":"Generates a Minecraft summary image for a specific player.","operationId":"create_minecraft_summary_by_id","parameters":[{"name":"uuid","in":"path","description":"Minecraft UUID of the player","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Minecraft summary image generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageResponse"}}}},"400":{"description":"Invalid UUID or not a Minecraft player"},"401":{"description":"Authentication required"},"403":{"description":"Player belongs to another account"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"500":{"description":"Internal server error"},"503":{"description":"Account verification unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}},"/api/monitoring":{"get":{"tags":["Monitoring"],"summary":"Retrieve the health status of all configured services.","description":"This endpoint performs real-time health checks (HTTP/TCP) on the services\ndefined in the configuration and returns an aggregated status report.","operationId":"get_monitoring_status","responses":{"200":{"description":"Aggregated health status of all services","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitoringResponse"}}}},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}}}},"/api/monitoring/check/{type}/{name}":{"get":{"tags":["Monitoring"],"summary":"Check the health of a specific service.","operationId":"check_single_service","parameters":[{"name":"type","in":"path","description":"Service type (discord, minecraft, etc.)","required":true,"schema":{"type":"string"}},{"name":"name","in":"path","description":"Service name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Health status of the specific service","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceResult"}}}},"404":{"description":"Service not found"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"}}}},"/api/saves/mkds/link":{"post":{"tags":["ROM"],"operationId":"link_mkds_save","requestBody":{"description":"Field `save`: raw Mario Kart DS EUR save (262144 bytes, starts with MKDSSV10)","content":{"multipart/form-data":{"schema":{"type":"string","format":"binary"}}},"required":true},"responses":{"200":{"description":"Linked copy of the save (application/octet-stream); `X-ADLN-Link: created|reused`"},"400":{"description":"Not a raw MKDS save, or malformed upload"},"401":{"description":"Authentication required"},"403":{"description":"Cross-origin request, service token, or save linked to another account"},"409":{"description":"Conflicting copies, revoked, unregistered or mismatched device"},"422":{"description":"Unknown data or two damaged copies in the reserved pages"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"502":{"description":"PocketBase or the recovery journal is unavailable; retry with the same file"},"503":{"description":"ADLN_DEVICE_WRAPPING_KEY is not configured"}}}},"/generated_images/{kind}/{owner}/{filename}":{"get":{"tags":["Images"],"summary":"Download a generated image as its owner or an administrator.","operationId":"get_image","parameters":[{"name":"kind","in":"path","description":"discord_summary or minecraft_summary","required":true,"schema":{"type":"string"}},{"name":"owner","in":"path","description":"Discord ID or Minecraft UUID","required":true,"schema":{"type":"string"}},{"name":"filename","in":"path","description":"64-character hexadecimal hash followed by .png","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Generated PNG image","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Authentication required"},"403":{"description":"Owner or administrator required"},"404":{"description":"Invalid image path or image not found"},"429":{"description":"10 requests per minute per route and account or anonymous IP; Retry-After in seconds"},"500":{"description":"Image read failed"},"503":{"description":"Ownership verification unavailable"}},"security":[{"session_cookie":[]},{"service_key":[]}]}}},"components":{"schemas":{"ActivityDay":{"type":"object","required":["date","message_count","vocal_hours"],"properties":{"date":{"type":"string"},"message_count":{"type":"integer","format":"int64"},"vocal_hours":{"type":"number","format":"double","description":"Decimal hours, as stored in PocketBase."}}},"AwardRequest":{"type":"object","required":["recipient","kind","badge"],"properties":{"badge":{"type":"string"},"kind":{"$ref":"#/components/schemas/RecipientKind"},"recipient":{"type":"string","description":"PocketBase record ID, not the Minecraft UUID or Discord snowflake."}},"additionalProperties":false},"AwardResult":{"type":"object","required":["badge","created"],"properties":{"badge":{"type":"string"},"created":{"type":"boolean"}}},"ChannelTotal":{"type":"object","required":["id","name","message_count","vocal_hours"],"properties":{"id":{"type":"string"},"message_count":{"type":"integer","format":"int64"},"name":{"type":"string"},"vocal_hours":{"type":"number","format":"double"}}},"DiscordActivity":{"type":"object","required":["total_messages","total_vocal_hours","undated_records","undated_messages","undated_vocal_hours","daily_complete","channel_counters_complete","daily","fetched_at"],"properties":{"channel_counters_complete":{"type":"boolean","description":"False when channel counters are missing; favorites use available counters only."},"daily":{"type":"array","items":{"$ref":"#/components/schemas/ActivityDay"}},"daily_complete":{"type":"boolean","description":"False if daily history is incomplete; day records use known dates only."},"favorite_text_channel":{"allOf":[{"$ref":"#/components/schemas/ChannelTotal"}],"nullable":true},"favorite_voice_channel":{"allOf":[{"$ref":"#/components/schemas/ChannelTotal"}],"nullable":true},"fetched_at":{"type":"string"},"record_messages_day":{"allOf":[{"$ref":"#/components/schemas/ActivityDay"}],"nullable":true},"record_vocal_day":{"allOf":[{"$ref":"#/components/schemas/ActivityDay"}],"nullable":true},"top_voice_companion":{"allOf":[{"$ref":"#/components/schemas/VoiceCompanion"}],"nullable":true},"total_messages":{"type":"integer","format":"int64"},"total_vocal_hours":{"type":"number","format":"double"},"undated_messages":{"type":"integer","format":"int64"},"undated_records":{"type":"integer","format":"int64","description":"Activity with an absent or invalid date is included in totals, but not daily.","minimum":0},"undated_vocal_hours":{"type":"number","format":"double"}}},"DiscordBotDiscordData":{"type":"object","description":"Discord-specific data for a bot.","required":["ping","avatar"],"properties":{"avatar":{"type":"string","description":"URL to the bot's avatar."},"ping":{"type":"integer","format":"int32","description":"Ping to Discord gateway.","minimum":0}}},"DiscordBotMetadata":{"type":"object","description":"Metadata for a Discord bot service.","required":["version","uptime","discord"],"properties":{"discord":{"$ref":"#/components/schemas/DiscordBotDiscordData"},"uptime":{"$ref":"#/components/schemas/DiscordBotUptime"},"version":{"type":"string","description":"Software version."}}},"DiscordBotUptime":{"type":"object","description":"Uptime information for a Discord bot.","required":["seconds","human"],"properties":{"human":{"type":"string","description":"Human-readable uptime string."},"seconds":{"type":"integer","format":"int64","description":"Uptime in seconds.","minimum":0}}},"DiscordChannel":{"type":"object","description":"Represents a Discord channel (text or voice).","required":["id","name"],"properties":{"id":{"type":"string","description":"Channel snowflake ID."},"name":{"type":"string","description":"Channel name."},"nb_message":{"type":"integer","format":"int64","nullable":true},"vocal_time":{"type":"number","format":"double","nullable":true}}},"DiscordRole":{"type":"object","description":"Represents a Discord role.","required":["id","name","color"],"properties":{"color":{"type":"string","description":"Hex color code of the role."},"id":{"type":"string","description":"Role snowflake ID."},"name":{"type":"string","description":"Role name."}}},"DiscordStats":{"type":"object","description":"Represents aggregated activity statistics for a Discord user.","required":["id","discord_user","message_count","vocal_time"],"properties":{"badges":{"type":"array","items":{"$ref":"#/components/schemas/DiscordBadge"},"nullable":true},"date_stats":{"type":"string","description":"Date these statistics were recorded."},"discord_user":{"type":"string","description":"Reference ID to the user."},"id":{"type":"string","description":"Internal stat entry ID."},"message_count":{"type":"integer","format":"int64","description":"Number of messages sent."},"text_channels":{"type":"array","items":{"$ref":"#/components/schemas/DiscordChannel"},"description":"Most active text channels.","nullable":true},"vocal_time":{"type":"string","description":"Total time spent in voice channels (as a decimal string or duration)."},"vocal_with":{"type":"array","items":{"$ref":"#/components/schemas/DiscordVoiceConnection"},"description":"Users most frequently spent time with in voice.","nullable":true},"voice_channels":{"type":"array","items":{"$ref":"#/components/schemas/DiscordChannel"},"description":"Most active voice channels.","nullable":true}}},"DiscordUser":{"type":"object","description":"Represents a Discord user and their aggregated state.","required":["id","username","discord_id","discord_tag","joined_at"],"properties":{"avatar_url":{"type":"string","nullable":true},"delete_at":{"type":"string","nullable":true},"discord_id":{"type":"string"},"discord_tag":{"type":"string"},"first_active_at":{"type":"string","nullable":true},"id":{"type":"string"},"is_admin":{"type":"boolean"},"is_verified":{"type":"boolean"},"joined_at":{"type":"string"},"last_active_at":{"type":"string","nullable":true},"roles":{"type":"array","items":{"$ref":"#/components/schemas/DiscordRole"}},"stats":{"type":"array","items":{"$ref":"#/components/schemas/DiscordStats"}},"username":{"type":"string"}}},"DiscordVoiceConnection":{"type":"object","description":"Represents a voice connection with another user.","required":["id","username"],"properties":{"id":{"type":"string","description":"Other user's snowflake ID."},"username":{"type":"string","description":"Other user's username."}}},"Friend":{"type":"object","required":["friendship_id","user","status","since"],"properties":{"friendship_id":{"type":"string"},"since":{"type":"string","description":"Request date for pending friendships, acceptance date otherwise."},"status":{"$ref":"#/components/schemas/FriendshipStatus"},"user":{"$ref":"#/components/schemas/FriendUser"}}},"FriendList":{"type":"object","required":["friends","incoming","outgoing"],"properties":{"friends":{"type":"array","items":{"$ref":"#/components/schemas/Friend"}},"incoming":{"type":"array","items":{"$ref":"#/components/schemas/Friend"},"description":"Requests received and awaiting this account's answer."},"outgoing":{"type":"array","items":{"$ref":"#/components/schemas/Friend"},"description":"Requests sent by this account."}}},"FriendUser":{"type":"object","description":"Public profile of the other member of a friendship.","required":["id"],"properties":{"avatar_url":{"type":"string","nullable":true},"discord_id":{"type":"string"},"discord_tag":{"type":"string"},"id":{"type":"string","description":"PocketBase discord_users record ID."},"username":{"type":"string"}}},"FriendshipResponse":{"type":"object","required":["friendship_id","status"],"properties":{"friendship_id":{"type":"string"},"status":{"$ref":"#/components/schemas/FriendshipStatus"}}},"FriendshipStatus":{"type":"string","enum":["pending","accepted"]},"GlobalDiscordActivity":{"allOf":[{"$ref":"#/components/schemas/DiscordActivity"},{"type":"object","required":["players"],"properties":{"players":{"type":"array","items":{"$ref":"#/components/schemas/PlayerActivity"}}}}]},"ImageRequest":{"type":"object","required":["prompt","width","height"],"properties":{"height":{"type":"integer","format":"int32","minimum":0},"prompt":{"type":"string"},"width":{"type":"integer","format":"int32","minimum":0}}},"ImageResponse":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}}},"InvestorStats":{"type":"object","description":"Current record counts in PocketBase, not activity or performance estimates.","required":["discord_users","minecraft_players","minecraft_servers","badges_awarded","fetched_at"],"properties":{"badges_awarded":{"type":"integer","format":"int32","minimum":0},"discord_users":{"type":"integer","format":"int32","minimum":0},"fetched_at":{"type":"string","description":"UTC time when the database queries completed."},"minecraft_players":{"type":"integer","format":"int32","minimum":0},"minecraft_servers":{"type":"integer","format":"int32","minimum":0}}},"MinecraftMetadata":{"type":"object","description":"Metadata for a Minecraft server.","required":["online_players","max_players"],"properties":{"max_players":{"type":"integer","format":"int32","description":"Maximum number of players allowed.","minimum":0},"online_players":{"type":"integer","format":"int32","description":"Number of players currently online.","minimum":0}}},"MinecraftPlayer":{"type":"object","description":"Collection : players","required":["id","discord_user","platform","account_id","playername","first_connected_at","last_connected_at"],"properties":{"account_id":{"type":"string","description":"Player's UUID."},"badges":{"type":"array","items":{"$ref":"#/components/schemas/PlayerBadge"},"description":"Player's earned badges","nullable":true},"collectionId":{"type":"string","description":"PocketBase collection id (used to build file URLs)."},"discord_user":{"type":"string","description":"Player\"s discord link account"},"first_connected_at":{"type":"string","description":"Timestamp of the player's first recorded activity."},"head":{"type":"string","description":"PocketBase file name of the player's head image (empty when absent)."},"id":{"type":"string"},"last_connected_at":{"type":"string","description":"Timestamp of the player's last recorded activity."},"platform":{"type":"string","description":"Player's platform."},"playername":{"type":"string","description":"Playername"},"server_colors":{"type":"object","description":"Mapping of server IDs to server colors","additionalProperties":{"type":"string"}},"server_names":{"type":"object","description":"Mapping of server IDs to server names","additionalProperties":{"type":"string"}},"stats":{"type":"array","items":{"$ref":"#/components/schemas/MinecraftStats"},"description":"Player's stats"}}},"MinecraftStats":{"type":"object","description":"Collection : players_stats","required":["id","server","account_id","playtime","deaths","mob_kills","player_kills","blocks_mined","blocks_placed","total_distance","distance_walked","distance_elytra","distance_fligth"],"properties":{"account_id":{"type":"string"},"achievements":{},"blocks_mined":{"type":"integer","format":"int64"},"blocks_placed":{"type":"integer","format":"int64"},"deaths":{"type":"integer","format":"int64"},"distance_elytra":{"type":"number","format":"double"},"distance_fligth":{"type":"number","format":"double"},"distance_walked":{"type":"number","format":"double"},"id":{"type":"string"},"items_broken":{},"items_crafted":{},"mob_kills":{"type":"integer","format":"int64"},"mobs_killed":{},"player_kills":{"type":"integer","format":"int64"},"playtime":{"type":"integer","format":"int64"},"server":{"type":"string"},"total_distance":{"type":"number","format":"double"}}},"MonitoringResponse":{"type":"object","description":"Aggregated response containing status for all monitored services.","required":["services"],"properties":{"services":{"type":"array","items":{"$ref":"#/components/schemas/ServiceResult"},"description":"List of status results for each configured service."}}},"NewBadge":{"type":"object","required":["id","name","description","platform","account"],"properties":{"account":{"type":"string"},"description":{"type":"string"},"id":{"type":"string"},"image_url":{"type":"string","nullable":true},"name":{"type":"string"},"platform":{"type":"string"}}},"PlayerActivity":{"type":"object","required":["id","stats"],"properties":{"discord_id":{"type":"string","nullable":true},"id":{"type":"string","description":"PocketBase account ID, or the stored reference for a deleted account."},"stats":{"$ref":"#/components/schemas/DiscordActivity"},"username":{"type":"string","nullable":true}}},"RecipientKind":{"type":"string","enum":["player","discord_user"]},"RefreshResponse":{"type":"object","required":["new_badges","accounts_checked","failed_accounts"],"properties":{"accounts_checked":{"type":"integer","minimum":0},"failed_accounts":{"type":"array","items":{"type":"string"}},"new_badges":{"type":"array","items":{"$ref":"#/components/schemas/NewBadge"}}}},"RomCodeResponse":{"type":"object","description":"Response when a ROM linking code is generated.","required":["code","expires_at","device_id"],"properties":{"code":{"type":"string"},"device_id":{"type":"string"},"expires_at":{"type":"string"}}},"RomDevice":{"type":"object","description":"A linked ROM device.","required":["id","label","created","updated","is_disabled"],"properties":{"created":{"type":"string"},"id":{"type":"string"},"is_disabled":{"type":"boolean"},"label":{"type":"string"},"updated":{"type":"string"}}},"RomDeviceList":{"type":"object","description":"List of linked ROM devices.","required":["devices"],"properties":{"devices":{"type":"array","items":{"$ref":"#/components/schemas/RomDevice"}}}},"RomTokenRequest":{"type":"object","description":"Request to exchange a linking code for a token.","required":["code"],"properties":{"code":{"type":"string"}}},"RomTokenResponse":{"type":"object","description":"Response carrying the freshly minted `rom_` token (shown once).","required":["token","device_id","label"],"properties":{"device_id":{"type":"string"},"label":{"type":"string"},"token":{"type":"string"}}},"Server":{"type":"object","description":"Collection : servers","required":["id","name","type","platform","is_enabled","is_global","created","updated"],"properties":{"container":{"type":"string","nullable":true},"created":{"type":"string"},"description":{"type":"string","nullable":true},"embed_color":{"type":"string","nullable":true},"id":{"type":"string"},"image":{"type":"string","nullable":true},"is_enabled":{"type":"boolean"},"is_global":{"type":"boolean"},"modpack":{"type":"string","nullable":true},"modpack_url":{"type":"string","nullable":true},"name":{"type":"string"},"platform":{"type":"string"},"type":{"type":"string"},"updated":{"type":"string"},"version":{"type":"string","nullable":true},"world_name":{"type":"string","nullable":true}}},"ServiceMetadata":{"oneOf":[{"$ref":"#/components/schemas/DiscordBotMetadata"},{"$ref":"#/components/schemas/MinecraftMetadata"}],"description":"Specific metadata based on the service type."},"ServiceResult":{"type":"object","description":"The result of a health check for a single service.","required":["name","type_name","status","response_time_ms"],"properties":{"error":{"type":"string","description":"Optional error message if the service is offline.","nullable":true},"metadata":{"allOf":[{"$ref":"#/components/schemas/ServiceMetadata"}],"nullable":true},"name":{"type":"string","description":"The name of the service."},"response_time_ms":{"type":"integer","format":"int64","description":"Response time in milliseconds.","minimum":0},"status":{"$ref":"#/components/schemas/ServiceStatus"},"type_name":{"type":"string","description":"The type of service (e.g., \"http\", \"minecraft\")."}}},"ServiceStatus":{"type":"string","description":"Represents the status of a monitored service.","enum":["UP","DOWN"]},"VoiceCompanion":{"type":"object","required":["id","username","records_together"],"properties":{"id":{"type":"string"},"records_together":{"type":"integer","format":"int64","description":"Number of distinct dated days with a record mentioning this user.","minimum":0},"username":{"type":"string"}}}},"securitySchemes":{"service_key":{"type":"http","scheme":"bearer"},"session_cookie":{"type":"apiKey","in":"cookie","name":"auth_token"}}}}