v2-recent-recent.yaml 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  1. # 由 openapi/scripts/generate.php 生成,请勿手改;补充写到 overrides/v2-recent-recent.yaml
  2. get:
  3. summary: '获取单个 recent/{recent}'
  4. tags:
  5. - recent
  6. operationId: get_api_v2_recent_recent_
  7. description: 实现:`RecentController@show`
  8. parameters:
  9. -
  10. name: recent
  11. in: path
  12. required: true
  13. schema:
  14. type: string
  15. responses:
  16. 200:
  17. description: '成功。业务失败时 HTTP 仍可能为 200,以 ok 字段为准。'
  18. content:
  19. application/json:
  20. schema:
  21. type: object
  22. properties:
  23. ok:
  24. type: boolean
  25. message:
  26. type: string
  27. data:
  28. type: object
  29. properties:
  30. id:
  31. type: string
  32. type:
  33. type: string
  34. article_id:
  35. type: string
  36. param:
  37. type: string
  38. nullable: true
  39. updated_at:
  40. type: string
  41. title:
  42. type: string
  43. 401:
  44. $ref: '../../main.yaml#/components/responses/Unauthorized'
  45. 422:
  46. $ref: '../../main.yaml#/components/responses/ValidationError'
  47. put:
  48. summary: '更新 recent/{recent}'
  49. tags:
  50. - recent
  51. operationId: put_api_v2_recent_recent_
  52. description: 实现:`RecentController@update`
  53. parameters:
  54. -
  55. name: recent
  56. in: path
  57. required: true
  58. schema:
  59. type: string
  60. responses:
  61. 200:
  62. description: '成功。业务失败时 HTTP 仍可能为 200,以 ok 字段为准。'
  63. content:
  64. application/json:
  65. schema:
  66. type: object
  67. properties:
  68. ok:
  69. type: boolean
  70. message:
  71. type: string
  72. data:
  73. type: object
  74. 401:
  75. $ref: '../../main.yaml#/components/responses/Unauthorized'
  76. 422:
  77. $ref: '../../main.yaml#/components/responses/ValidationError'
  78. patch:
  79. summary: '更新 recent/{recent}'
  80. tags:
  81. - recent
  82. operationId: patch_api_v2_recent_recent_
  83. description: 实现:`RecentController@update`
  84. parameters:
  85. -
  86. name: recent
  87. in: path
  88. required: true
  89. schema:
  90. type: string
  91. responses:
  92. 200:
  93. description: '成功。业务失败时 HTTP 仍可能为 200,以 ok 字段为准。'
  94. content:
  95. application/json:
  96. schema:
  97. type: object
  98. properties:
  99. ok:
  100. type: boolean
  101. message:
  102. type: string
  103. data:
  104. type: object
  105. 401:
  106. $ref: '../../main.yaml#/components/responses/Unauthorized'
  107. 422:
  108. $ref: '../../main.yaml#/components/responses/ValidationError'
  109. delete:
  110. summary: '删除 recent/{recent}'
  111. tags:
  112. - recent
  113. operationId: delete_api_v2_recent_recent_
  114. description: 实现:`RecentController@destroy`
  115. parameters:
  116. -
  117. name: recent
  118. in: path
  119. required: true
  120. schema:
  121. type: string
  122. responses:
  123. 200:
  124. description: '成功。业务失败时 HTTP 仍可能为 200,以 ok 字段为准。'
  125. content:
  126. application/json:
  127. schema:
  128. type: object
  129. properties:
  130. ok:
  131. type: boolean
  132. message:
  133. type: string
  134. data:
  135. type: object
  136. 401:
  137. $ref: '../../main.yaml#/components/responses/Unauthorized'
  138. 422:
  139. $ref: '../../main.yaml#/components/responses/ValidationError'