6158.yaml 1.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. openapi: 3.0.0
  2. info:
  3. title: "Swagger Test"
  4. version: "1.0.0"
  5. servers:
  6. - url: https://api.example.com/v1
  7. paths:
  8. /users:
  9. get:
  10. tags:
  11. - User
  12. summary: Get Users
  13. responses:
  14. 200:
  15. description: User List
  16. content:
  17. application/json:
  18. schema:
  19. type: array
  20. items:
  21. $ref: '#/components/schemas/User'
  22. post:
  23. tags:
  24. - User
  25. summary: Create a user
  26. requestBody:
  27. content:
  28. application/x-www-form-urlencoded:
  29. schema:
  30. $ref: '#/components/schemas/User'
  31. responses:
  32. 201:
  33. description: Created successfully
  34. put:
  35. tags:
  36. - User
  37. summary: Update user
  38. requestBody:
  39. content:
  40. application/x-www-form-urlencoded:
  41. schema:
  42. $ref: '#/components/schemas/User'
  43. responses:
  44. 201:
  45. description: Created successfully
  46. components:
  47. schemas:
  48. User:
  49. type: object
  50. properties:
  51. id:
  52. type: integer
  53. readOnly: true
  54. name:
  55. type: string
  56. required:
  57. - name