store.yaml 963 B

123456789101112131415161718192021222324252627282930313233343536373839
  1. post:
  2. summary: 新建一条discussion.
  3. tags:
  4. - discussion
  5. description:
  6. parameters:
  7. - name: title
  8. in: path
  9. required: false
  10. description: title of discussion 建立新问题时, title为必填项目
  11. schema:
  12. type: string
  13. - name: content
  14. in: path
  15. required: false
  16. description: content of discussion
  17. schema:
  18. type: string
  19. - name: parent
  20. in: path
  21. required: false
  22. description: 回答的问题的id. 建立问题时无需此参数。建立回答时需要。
  23. schema:
  24. type: uuid
  25. responses:
  26. "200": # status code
  27. description: A JSON array of user names
  28. content:
  29. application/json:
  30. schema:
  31. type: object
  32. properties:
  33. ok:
  34. type: boolean
  35. message:
  36. type: string
  37. data:
  38. type: object
  39. $ref: "./data.yaml"