mint/openapi/public/assets/protocol/resources/auto/v2-discussion-discussion.yaml

# 由 openapi/scripts/generate.php 生成，请勿手改；补充写到 overrides/v2-discussion-discussion.yaml
get:
  summary: 查询单条讨论
  tags:
    - discussion
  operationId: get_api_v2_discussion_discussion_
  description: |
    已被 `GET /v3/discussions/{discussion}` 取代。保留仅为 dashboard-v4 兼容，待 v4 下线后删除。
  parameters:
    -
      name: discussion
      in: path
      required: true
      schema:
        type: string
      description: '讨论 id'
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
                properties:
                  id:
                    type: integer
                  title:
                    type: string
                  content:
                    type: string
                  content_type:
                    type: string
                  parent:
                    type: string
                  status:
                    type: integer
                  editor:
                    type: string
                  res_id:
                    type: integer
                  res_type:
                    type: string
                  type:
                    type: integer
                  tpl_id:
                    type: integer
                  children_count:
                    type: integer
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  pos_start:
                    type: string
                  pos_end:
                    type: string
                  quote_exact:
                    type: string
                  quote_prefix:
                    type: string
                  quote_suffix:
                    type: string
                  html:
                    type: string
                  summary:
                    type: string
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
  deprecated: true
put:
  summary: '修改讨论 / 批注'
  tags:
    - discussion
  operationId: put_api_v2_discussion_discussion_
  description: |
    已被 `PATCH /v3/discussions/{discussion}`（局部更新）取代。保留仅为 dashboard-v4 兼容，待 v4 下线后删除。
  parameters:
    -
      name: discussion
      in: path
      required: true
      schema:
        type: string
      description: '讨论 id'
  requestBody:
    required: false
    content:
      application/json:
        schema:
          type: object
          properties:
            title:
              type: string
              description: 标题，未提交会被清空
            content:
              type: string
              description: 正文内容，未提交会被清空
            status:
              type: string
              description: '状态，未提交会重置为 active'
              enum:
                - active
                - close
              default: active
            type:
              type: string
              description: 讨论类型，仅在提交时更新
              enum:
                - discussion
                - qa
                - help
                - note
                - commentary
            pos_start:
              type: integer
              description: 锚点起始偏移，仅在提交时更新
            pos_end:
              type: integer
              description: 锚点结束偏移，仅在提交时更新
            quote_exact:
              type: string
              description: 锚定的原文片段，仅在提交时更新
            quote_prefix:
              type: string
              description: 锚定片段前的上下文，仅在提交时更新
            quote_suffix:
              type: string
              description: 锚定片段后的上下文，仅在提交时更新
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
                properties:
                  id:
                    type: integer
                  title:
                    type: string
                  content:
                    type: string
                  content_type:
                    type: string
                  parent:
                    type: string
                  status:
                    type: integer
                  editor:
                    type: string
                  res_id:
                    type: integer
                  res_type:
                    type: string
                  type:
                    type: integer
                  tpl_id:
                    type: integer
                  children_count:
                    type: integer
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  pos_start:
                    type: string
                  pos_end:
                    type: string
                  quote_exact:
                    type: string
                  quote_prefix:
                    type: string
                  quote_suffix:
                    type: string
                  html:
                    type: string
                  summary:
                    type: string
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
  deprecated: true
patch:
  summary: '修改讨论 / 批注'
  tags:
    - discussion
  operationId: patch_api_v2_discussion_discussion_
  description: |
    已被 `PATCH /v3/discussions/{discussion}`（局部更新）取代。保留仅为 dashboard-v4 兼容，待 v4 下线后删除。
  parameters:
    -
      name: discussion
      in: path
      required: true
      schema:
        type: string
      description: '讨论 id'
  requestBody:
    required: false
    content:
      application/json:
        schema:
          type: object
          properties:
            title:
              type: string
              description: 标题，未提交会被清空
            content:
              type: string
              description: 正文内容，未提交会被清空
            status:
              type: string
              description: '状态，未提交会重置为 active'
              enum:
                - active
                - close
              default: active
            type:
              type: string
              description: 讨论类型，仅在提交时更新
              enum:
                - discussion
                - qa
                - help
                - note
                - commentary
            pos_start:
              type: integer
              description: 锚点起始偏移，仅在提交时更新
            pos_end:
              type: integer
              description: 锚点结束偏移，仅在提交时更新
            quote_exact:
              type: string
              description: 锚定的原文片段，仅在提交时更新
            quote_prefix:
              type: string
              description: 锚定片段前的上下文，仅在提交时更新
            quote_suffix:
              type: string
              description: 锚定片段后的上下文，仅在提交时更新
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
                properties:
                  id:
                    type: integer
                  title:
                    type: string
                  content:
                    type: string
                  content_type:
                    type: string
                  parent:
                    type: string
                  status:
                    type: integer
                  editor:
                    type: string
                  res_id:
                    type: integer
                  res_type:
                    type: string
                  type:
                    type: integer
                  tpl_id:
                    type: integer
                  children_count:
                    type: integer
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  pos_start:
                    type: string
                  pos_end:
                    type: string
                  quote_exact:
                    type: string
                  quote_prefix:
                    type: string
                  quote_suffix:
                    type: string
                  html:
                    type: string
                  summary:
                    type: string
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
  deprecated: true
delete:
  summary: '删除讨论 / 批注'
  tags:
    - discussion
  operationId: delete_api_v2_discussion_discussion_
  description: |
    已被 `DELETE /v3/discussions/{discussion}` 取代。2026-10-15 起两边都是软删除。
    保留仅为 dashboard-v4 兼容，待 v4 下线后删除。
  parameters:
    -
      name: discussion
      in: path
      required: true
      schema:
        type: string
      description: '讨论 id'
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
  deprecated: true