{"openapi":"3.1.0","info":{"title":"Hydro Playground API","version":"1.0.0"},"paths":{"/api/authors":{"get":{"summary":"List Author","description":"A richer demo resource with filters, sorting, relationships and custom operations.","tags":["Author"],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"itemsPerPage","in":"query","schema":{"type":"integer","minimum":1}},{"name":"fields","in":"query","schema":{"type":"string"}},{"name":"order[field]","in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"name","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"active","in":"query","schema":{"type":"string"}},{"name":"featured","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"x-total-count":{"schema":{"type":"integer"}},"x-has-more":{"schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Author"}}}}}}},"post":{"summary":"Create Author","tags":["Author"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Author"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Author"}}}},"422":{"$ref":"#/components/responses/ValidationError"}}}},"/api/authors/{id}":{"get":{"summary":"Get Author","tags":["Author"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Author"}}}},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"summary":"Update Author","tags":["Author"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Author"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Author"}}}},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationError"}}},"delete":{"summary":"Delete Author","tags":["Author"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/authors/{id}/feature":{"post":{"summary":"feature Author","tags":["Author"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"featured":{"default":true,"type":"boolean"}},"required":["featured"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"featured":{"type":"boolean"}},"required":["featured"],"additionalProperties":false}}}}}}},"/api/authors/spotlight":{"post":{"summary":"spotlight Author","tags":["Author"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":2}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"bookCount":{"type":"number"}},"required":["name","bookCount"],"additionalProperties":false}}}}}}}},"/api/books":{"get":{"summary":"List Book","tags":["Book"],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"itemsPerPage","in":"query","schema":{"type":"integer","minimum":1}},{"name":"fields","in":"query","schema":{"type":"string"}},{"name":"order[field]","in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"title","in":"query","schema":{"type":"string"}},{"name":"authorId","in":"query","schema":{"type":"string"}},{"name":"available","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"x-total-count":{"schema":{"type":"integer"}},"x-has-more":{"schema":{"type":"boolean"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Book"}}}}}}},"post":{"summary":"Create Book","tags":["Book"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Book"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Book"}}}},"422":{"$ref":"#/components/responses/ValidationError"}}}},"/api/books/{id}":{"get":{"summary":"Get Book","tags":["Book"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Book"}}}},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"summary":"Update Book","tags":["Book"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Book"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Book"}}}},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationError"}}},"delete":{"summary":"Delete Book","tags":["Book"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/books/{id}/checkout":{"post":{"summary":"checkout Book","tags":["Book"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"available":{"type":"boolean"}},"required":["available"],"additionalProperties":false}}}}}}}},"components":{"schemas":{"Author":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":120},"country":{"type":"string","minLength":2,"maxLength":2},"bio":{"type":"string","maxLength":1000},"active":{"default":true,"type":"boolean"},"featured":{"default":false,"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"books":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"available":{"default":true,"type":"boolean"}},"required":["title","available"],"additionalProperties":false}]}}},"required":["name","country","active","featured"],"additionalProperties":false},"Book":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string","minLength":1,"maxLength":200},"author":{"type":"string"},"authorId":{"type":"string"},"available":{"default":true,"type":"boolean"}},"required":["title","available"],"additionalProperties":false}},"responses":{"NotFound":{"description":"Not found"},"ValidationError":{"description":"Validation failed","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string"},"message":{"type":"string"},"code":{"type":"string"}},"required":["propertyPath","message"]}}},"required":["type","title","status"]}}}}}}}