openapi: 3.0.0
info:
  title: Coze 网关API
  version: 1.0.0
  description: 课程对话与陪练网关最小契约（骨架）

paths:
  /api/v1/course-chat/sessions:
    post:
      summary: 创建课程对话会话
      tags: [Coze]
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [course_id]
              properties:
                course_id: { type: integer }
      responses:
        201:
          description: 已创建

  /api/v1/training/sessions:
    post:
      summary: 创建陪练会话
      tags: [Coze]
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [scene_id]
              properties:
                scene_id: { type: integer }
      responses:
        201:
          description: 已创建

  /api/v1/training/sessions/{id}/end:
    post:
      summary: 结束陪练会话
      tags: [Coze]
      security:
        - bearerAuth: []
      parameters:
        - in: path
          name: id
          required: true
          schema: { type: string }
      responses:
        200:
          description: 已结束

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

