v2-search-book-list.yaml 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. # 由 openapi/scripts/generate.php 生成,请勿手改;补充写到 overrides/v2-search-book-list.yaml
  2. get:
  3. summary: 'book_list search-book-list'
  4. tags:
  5. - search-book-list
  6. operationId: get_api_v2_search_book_list
  7. description: 实现:`SearchController@book_list`
  8. parameters:
  9. -
  10. name: tags
  11. in: query
  12. schema:
  13. type: string
  14. -
  15. name: key
  16. in: query
  17. schema:
  18. type: string
  19. -
  20. name: view
  21. in: query
  22. schema:
  23. type: string
  24. enum:
  25. - pali
  26. - page
  27. - title
  28. default: pali
  29. -
  30. name: match
  31. in: query
  32. schema:
  33. type: string
  34. default: case
  35. -
  36. name: type
  37. in: query
  38. schema:
  39. type: string
  40. default: P
  41. responses:
  42. 200:
  43. description: '成功。业务失败时 HTTP 仍可能为 200,以 ok 字段为准。'
  44. content:
  45. application/json:
  46. schema:
  47. type: object
  48. properties:
  49. ok:
  50. type: boolean
  51. message:
  52. type: string
  53. data:
  54. type: object
  55. properties:
  56. pcdBookId:
  57. type: string
  58. count:
  59. type: integer
  60. book:
  61. type: string
  62. paragraph:
  63. type: string
  64. paliTitle:
  65. type: string
  66. tags:
  67. type: string
  68. 401:
  69. $ref: '../../main.yaml#/components/responses/Unauthorized'
  70. 422:
  71. $ref: '../../main.yaml#/components/responses/ValidationError'