v3-discussions-summary.yaml 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. # 由 openapi/scripts/generate.php 生成,请勿手改;补充写到 overrides/v3-discussions-summary.yaml
  2. get:
  3. summary: 话题概况
  4. tags:
  5. - discussions
  6. operationId: get_api_v3_discussions_summary
  7. description: |-
  8. 各状态的话题数(只数没删除的、当前用户看得见的),以及当前用户能在这个对象上
  9. 发起哪些类型的话题(未登录为空数组)。
  10. 实现:`V3\DiscussionSummaryController@__invoke`
  11. security:
  12. - { }
  13. -
  14. bearerAuth: []
  15. parameters:
  16. -
  17. name: target_type
  18. in: query
  19. schema:
  20. type: string
  21. enum:
  22. - sentence
  23. - wbw
  24. - article
  25. - term
  26. - task
  27. description: 挂靠对象的类型
  28. required: true
  29. -
  30. name: target_id
  31. in: query
  32. schema:
  33. type: string
  34. description: '挂靠对象的 uuid'
  35. required: true
  36. -
  37. name: type
  38. in: query
  39. schema:
  40. type: string
  41. enum:
  42. - discussion
  43. - qa
  44. - help
  45. - issue
  46. - note
  47. - commentary
  48. description: 只数这种类型,不传则只数评论线程
  49. responses:
  50. 200:
  51. description: 成功
  52. content:
  53. application/json:
  54. schema:
  55. type: object
  56. properties:
  57. data:
  58. type: object
  59. properties:
  60. status_counts:
  61. type: object
  62. properties:
  63. active: { type: integer }
  64. close: { type: integer }
  65. creatable_types:
  66. type: array
  67. items:
  68. type: string
  69. 422:
  70. $ref: '../../main.yaml#/components/responses/ProblemValidation'