swagger.json

{"openapi":"3.0.0","info":{"title":"ACME Products API Reference","version":"0.1.3-dev"},"paths":{"/api/products":{"get":{"description":"Get Products","operationId":"get_/api/products","parameters":[{"in":"query","name":"name","schema":{"type":"string","minLength":1,"maxLength":100},"required":false},{"in":"query","name":"categories","schema":{"type":"string"},"required":false}],"responses":{"200":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}},"post":{"description":"Create product","operationId":"post_/api/products","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string","minLength":1,"maxLength":100},"price":{"type":"number","minimum":0.01,"maximum":1000000},"categories":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},"required":["id","name","price","categories"]}}},"required":true},"responses":{"201":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/products/{productId}":{"get":{"description":"Get Product","operationId":"get_/api/products/:productId","parameters":[{"in":"path","name":"productId","schema":{"type":"number"},"required":true}],"responses":{"200":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}},"patch":{"description":"Update Product","operationId":"patch_/api/products/:productId","parameters":[{"in":"path","name":"productId","schema":{"type":"number"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string","minLength":1,"maxLength":100},"price":{"type":"number","minimum":0.01,"maximum":1000000},"categories":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}}}}},"required":true},"responses":{"200":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}},"delete":{"description":"Delete Product","operationId":"delete_/api/products/:productId","parameters":[{"in":"path","name":"productId","schema":{"type":"number"},"required":true}],"responses":{"204":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/products/{productId}/images/{imageId}":{"get":{"description":"Get Product Image","operationId":"get_/api/products/:productId/images/:imageId","parameters":[{"in":"path","name":"productId","schema":{"type":"number"},"required":true},{"in":"path","name":"imageId","schema":{"type":"number"},"required":true}],"responses":{"200":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/products/{productId}/images":{"get":{"description":"Get Product Images","operationId":"get_/api/products/:productId/images","parameters":[{"in":"path","name":"productId","schema":{"type":"number"},"required":true}],"responses":{"200":{"description":"No content"},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}},"post":{"description":"Upload a product image","operationId":"post_/api/products/:productId/images","parameters":[{"in":"path","name":"productId","schema":{"type":"number"},"required":true}],"requestBody":{"description":"The image file","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"imageFile":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Product Image","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"imageUrl":{"type":"string"}}}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object"}}}}}}}}}},"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"session.id"}}}}