openapi: 3.1.0
info:
  title: PlatPhorm News Alt API
  version: 0.6.0
  description: Public read-only discovery and current Hacker News story access.
servers:
  - url: https://altnews.platphormnews.com
paths:
  /api/health:
    get:
      summary: Public health summary
      responses:
        '200': { description: Health envelope }
  /api/stories/{type}:
    get:
      summary: Read live Hacker News stories
      parameters:
        - name: type
          in: path
          required: true
          schema: { type: string, enum: [top, best, new, ask, show, jobs] }
      responses:
        '200': { description: Story list }
  /api/mcp:
    get:
      summary: MCP metadata
      responses:
        '200': { description: Metadata }
    post:
      summary: JSON-RPC 2.0 MCP request
      responses:
        '200': { description: JSON-RPC response }
components:
  securitySchemes:
    PlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
      description: Protected platform actions also accept Authorization Bearer PLATPHORM_API_KEY.
