|
|
@@ -0,0 +1,188 @@
|
|
|
+# 由 openapi/scripts/generate.php 生成，请勿手改；补充写到 overrides/v3-tipitaka-discussions-channel.yaml
|
|
|
+get:
|
|
|
+ summary: 列出一段经文里的话题
|
|
|
+ tags:
|
|
|
+ - tipitaka-discussions
|
|
|
+ operationId: get_api_v3_tipitaka_discussions_channel_
|
|
|
+ description: |-
|
|
|
+ 只列挂在该 channel 句子上的话题（不含回复），按经文顺序（书、段、句）排列，同一句里按时间；
|
|
|
+ 每条带 `sentence`（所在句子的坐标）。删除了但还有回复的话题以墓碑出现。
|
|
|
+ 不传 type 时只列评论线程（discussion / qa / help / issue / glossary），批注要显式
|
|
|
+ type=note / commentary。可见性同 `GET /v3/discussions`：未登录看不到 discussion；
|
|
|
+ basic 角色在自己不能编辑的 channel 上只看得到自己发起的 discussion。
|
|
|
+ channel 不存在或范围内没有讨论都返回空列表；chapter 不存在 404。
|
|
|
+
|
|
|
+ 实现：`V3\TipitakaDiscussionController@__invoke`
|
|
|
+ security:
|
|
|
+ - { }
|
|
|
+ -
|
|
|
+ bearerAuth: []
|
|
|
+ parameters:
|
|
|
+ -
|
|
|
+ name: channel
|
|
|
+ in: path
|
|
|
+ required: true
|
|
|
+ schema:
|
|
|
+ type: string
|
|
|
+ description: '句子所在 channel 的 uuid'
|
|
|
+ -
|
|
|
+ name: per_page
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: integer
|
|
|
+ default: 15
|
|
|
+ description: '每页数量，最大 200'
|
|
|
+ -
|
|
|
+ name: book
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: integer
|
|
|
+ description: '书号；与 chapter / para / to 一起用时必填，不传则是整个 channel'
|
|
|
+ example: 169
|
|
|
+ -
|
|
|
+ name: chapter
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: integer
|
|
|
+ description: '章节起始段落号，服务端按章节长度展开成段落区间；不能与 para / to 同用'
|
|
|
+ example: 893
|
|
|
+ -
|
|
|
+ name: para
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: integer
|
|
|
+ description: 起始段落号
|
|
|
+ example: 895
|
|
|
+ -
|
|
|
+ name: to
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: integer
|
|
|
+ description: '结束段落号（含），缺省同 para'
|
|
|
+ example: 896
|
|
|
+ -
|
|
|
+ name: type
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: string
|
|
|
+ description: 类型，逗号分隔多选；不传则只列评论线程
|
|
|
+ example: 'issue,glossary'
|
|
|
+ -
|
|
|
+ name: status
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: string
|
|
|
+ enum:
|
|
|
+ - active
|
|
|
+ - close
|
|
|
+ description: 话题状态，不传则两种都要
|
|
|
+ -
|
|
|
+ name: severity
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: string
|
|
|
+ description: 严重程度，逗号分隔多选
|
|
|
+ example: 'error,warning'
|
|
|
+ -
|
|
|
+ name: page
|
|
|
+ in: query
|
|
|
+ schema:
|
|
|
+ type: integer
|
|
|
+ default: 1
|
|
|
+ description: 页码
|
|
|
+ responses:
|
|
|
+ 200:
|
|
|
+ description: 成功
|
|
|
+ content:
|
|
|
+ application/json:
|
|
|
+ schema:
|
|
|
+ type: object
|
|
|
+ properties:
|
|
|
+ data:
|
|
|
+ type: array
|
|
|
+ items:
|
|
|
+ type: object
|
|
|
+ properties:
|
|
|
+ id:
|
|
|
+ type: string
|
|
|
+ target_type:
|
|
|
+ type: string
|
|
|
+ target_id:
|
|
|
+ type: string
|
|
|
+ parent_id:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ type:
|
|
|
+ type: string
|
|
|
+ severity:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ status:
|
|
|
+ type: string
|
|
|
+ title:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ content:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ content_type:
|
|
|
+ type: string
|
|
|
+ html:
|
|
|
+ type: string
|
|
|
+ description: 仅在部分查询口径下返回。
|
|
|
+ summary:
|
|
|
+ type: string
|
|
|
+ description: 仅在部分查询口径下返回。
|
|
|
+ tpl_id:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ pos_start:
|
|
|
+ type: integer
|
|
|
+ nullable: true
|
|
|
+ pos_end:
|
|
|
+ type: integer
|
|
|
+ nullable: true
|
|
|
+ quote_exact:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ quote_prefix:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ quote_suffix:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ reply_count:
|
|
|
+ type: integer
|
|
|
+ description: 仅在部分查询口径下返回。
|
|
|
+ sentence:
|
|
|
+ type: object
|
|
|
+ properties: { book: { type: integer }, paragraph: { type: integer }, word_start: { type: integer }, word_end: { type: integer } }
|
|
|
+ description: 仅在部分查询口径下返回。
|
|
|
+ editor:
|
|
|
+ type: object
|
|
|
+ properties: { id: { type: string }, nickName: { type: string }, userName: { type: string }, realName: { type: string }, sn: { type: integer }, avatar: { type: string }, roles: { type: array, items: { type: string } } }
|
|
|
+ nullable: true
|
|
|
+ co_editor:
|
|
|
+ type: object
|
|
|
+ properties: { id: { type: string }, nickName: { type: string }, userName: { type: string }, realName: { type: string }, sn: { type: integer }, avatar: { type: string }, roles: { type: array, items: { type: string } } }
|
|
|
+ nullable: true
|
|
|
+ abilities:
|
|
|
+ type: object
|
|
|
+ properties: { update: { type: boolean }, delete: { type: boolean }, close: { type: boolean }, reply: { type: boolean } }
|
|
|
+ created_at:
|
|
|
+ type: string
|
|
|
+ updated_at:
|
|
|
+ type: string
|
|
|
+ deleted_at:
|
|
|
+ type: string
|
|
|
+ nullable: true
|
|
|
+ meta:
|
|
|
+ $ref: '../../main.yaml#/components/schemas/PaginationMeta'
|
|
|
+ 404:
|
|
|
+ description: 'chapter 不是本书存在的段落'
|
|
|
+ content:
|
|
|
+ application/problem+json:
|
|
|
+ schema:
|
|
|
+ $ref: '../../main.yaml#/components/schemas/ProblemDetails'
|
|
|
+ 422:
|
|
|
+ $ref: '../../main.yaml#/components/responses/ProblemValidation'
|
