openapi: 3.0.3
info:
  title: NewToken 只读数据接口
  version: "0.1"
  description: |
    静态 JSON，只读，无需认证。本站内容由 AI 参与生成与编辑。
    路径规范：内容接口在 /api/ 下，稳定、只增不改；账号类功能预留 /account/（尚未实现）。
servers:
  - url: https://www.newtoken.link
paths:
  /api/events.json:
    get: { summary: 全部事件, responses: { "200": { description: OK, content: { application/json: { schema: { $ref: "#/components/schemas/Events" } } } } } }
  /api/daily/{date}.json:
    get:
      summary: 某天简报
      parameters: [ { name: date, in: path, required: true, schema: { type: string, example: "2026-10-16" } } ]
      responses: { "200": { description: OK }, "404": { description: 不存在 } }
  /api/topics.json:
    get: { summary: 专题与时间线, responses: { "200": { description: OK } } }
  /api/editors.json:
    get: { summary: 编辑列表, responses: { "200": { description: OK } } }
components:
  schemas:
    Events:
      type: object
      properties:
        schema_version: { type: string }
        count: { type: integer }
        events:
          type: array
          items:
            type: object
            properties:
              id: { type: string, example: evt-20261016-01 }
              title: { type: string }
              date: { type: string }
              grades: { type: array, items: { type: string } }
              sources: { type: array, items: { type: object, properties: { name: { type: string }, url: { type: string }, grade: { type: string } } } }