{"openapi":"3.0.0","servers":[],"info":{"version":"1.0.0","title":"12chairs","description":"The API for the furniture company"},"paths":{"/orders/get/{orderId}":{"get":{"tags":["Orders"],"operationId":"getOrderDetails","summary":"Получение детальной информации о заказе по его идентификатору","description":"Проверяем, что заказ есть в БД. Проверяем, что он доступен текущему пользователю (определяем его из токена, переданного в Authorization). При успешных проверках возвращаем информацию о заказе. Иначе - соответствующий тип ошибки.","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderDetails"}}}},"404":{"description":"Заказ с таким ID не найден"},"401":{"description":"Пользователь не авторизован"},"403":{"description":"Нет прав на операцию"}},"x-swagger-router-controller":"Orders"}},"/orders/update/{orderId}":{"post":{"tags":["Orders"],"operationId":"updateOrderDetails","summary":"Обновление существующего заказа","description":"Проверяем наличие заказа в БД. Проверяем права доступа к нему, получив пользователя из токена в Authorization. При успехе пытаемся сохранить в БД обновленные данные заказа.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderDetails"}}}},"parameters":[{"name":"orderId","in":"path","description":"ID заказа, информацию о котором нужно обновить","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Информация о заказе успешно обновлена","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDetails"}}}},"404":{"description":"Заказ с таким ID не найден"},"401":{"description":"Пользователь не авторизован"},"403":{"description":"Нет прав на операцию"}},"x-swagger-router-controller":"Orders"}},"/orders/confirm/{orderId}":{"get":{"tags":["Orders"],"operationId":"confirmOrder","summary":"Подтверждение заказа","description":"Подтвердить можно уже сохраненный через /update заказ. Проверяем наличие заказа и права на его изменение. Пытаемся забронировать нужное кличество товара для каждого товара в заказе посредством storages/book-products-for-order. Возвращаем статус операции с описанием успеха/ошибки.","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Заказ принят в обработку"},"401":{"description":"Пользователь не авторизован"},"403":{"description":"Нет прав на операцию"},"404":{"description":"Заказ с таким ID не найден"},"512":{"description":"Сервис доставки временно недоступен, попробуйте позже"},"513":{"description":"Превышено максимальное количество попыток обращения к сервису доставки, попробуйте позже"}},"x-swagger-router-controller":"Orders"}},"/products/get/{productId}":{"get":{"tags":["Products"],"operationId":"getProductDetails","summary":"Получение информации о товаре по его идентификатору","description":"Проверяем наличие товара в БД и возвращаем его параметры в заданном формате. Если товар не найден, возвращаем соответствующую ошибку.","parameters":[{"name":"productId","in":"path","required":true,"description":"Идентификатор запрашиваемого товара","schema":{"type":"string"}}],"responses":{"200":{"description":"response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetails"}}}}},"x-swagger-router-controller":"Orders"}}},"components":{"schemas":{"ProductDetails":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0729a580-2240-11e6-9eb5-0002a5d5c51b"},"name":{"type":"string"},"color":{"type":"string"},"description":{"type":"string"}}},"OrderItemDetails":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0729a580-2240-11e6-9eb5-0002a5d5c51b"},"productId":{"type":"string","format":"uuid","example":"0729a580-2240-11e6-9eb5-0002a5d5c51b"},"discount":{"type":"integer"},"price":{"type":"number"},"count":{"type":"integer"}}},"OrderDetails":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0729a580-2240-11e6-9eb5-0002a5d5c51b"},"clientId":{"type":"string","format":"uuid","example":"0729a580-2240-11e6-9eb5-0002a5d5c51b"},"status":{"type":"string"},"createDateTime":{"type":"string","format":"date-time"},"lastModifyDateTime":{"type":"string","format":"date-time"},"items":{"type":"array","items":{"$ref":"#/components/schemas/OrderItemDetails"}}}},"ResponseDetails":{"type":"object","properties":{"responseStatus":{"type":"string"},"responseDescription":{"type":"string"}}}}}}