openapi: 3.1.0
info:
  title: Game Core API
  version: 0.1.0
  description: Public Game Core health, discovery, and QuakeCraft integration API.
servers:
  - url: https://gamecore.platphormnews.com
paths:
  /api/health:
    get:
      summary: Public Game Core health
      responses: { '200': { description: OK } }
  /api/v1/health:
    get:
      summary: Versioned public Game Core health
      responses: { '200': { description: OK } }
  /api/docs:
    get:
      summary: API documentation
      responses: { '200': { description: OK } }
  /api/mcp:
    get:
      summary: MCP metadata
      responses: { '200': { description: OK } }
    post:
      summary: MCP JSON-RPC 2.0 endpoint
      responses: { '200': { description: JSON-RPC response } }
  /api/quake-discovery:
    get:
      summary: Bounded Quake discovery availability crawl
      responses: { '200': { description: OK } }
  /api/steam/profile:
    get:
      summary: Read a Steam profile by SteamID64
      parameters:
        - name: steamid
          in: query
          required: true
          schema: { type: string, pattern: '^\\d{10,20}$' }
      responses: { '200': { description: OK }, '400': { description: Invalid SteamID64 }, '503': { description: Steam not configured } }
components:
  securitySchemes:
    PlatPhormBearer: { type: http, scheme: bearer, description: PLATPHORM_API_KEY }
    PlatPhormApiKey: { type: apiKey, in: header, name: X-PlatPhorm-API-Key, description: PLATPHORM_API_KEY }