{"id":317749,"date":"2021-02-09T15:01:27","date_gmt":"2021-02-09T15:01:27","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=317749"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=317749","title":{"rendered":"Swagger (OpenAPI 3.0)"},"content":{"rendered":"\n<div class=\"post__text post__text_v2\" id=\"post-content-body\">\n<p>\u0412\u0441\u0435\u043c \u043f\u0440\u0438\u0432\u0435\u0442!!! \u042d\u0442\u043e \u043c\u043e\u0439 \u043f\u0435\u0440\u0432\u044b\u0439 \u043f\u043e\u0441\u0442 \u043d\u0430 \u0425\u0430\u0431\u0440\u0435 \u0438 \u044f \u0445\u043e\u0447\u0443 \u043f\u043e\u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u0441 \u0432\u0430\u043c\u0438 \u0441\u0432\u043e\u0438\u043c \u043e\u043f\u044b\u0442\u043e\u043c \u0432 \u0438\u0441\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435 \u043d\u043e\u0432\u043e\u0433\u043e \u0434\u043b\u044f \u0441\u0435\u0431\u044f \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0430. <\/p>\n<p>\u041c\u043d\u0435 \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u0438\u043b\u0441\u044f \u043c\u043e\u043c\u0435\u043d\u0442 \u0432\u044b\u0431\u0440\u0430\u0442\u044c \u0442\u0435\u043c\u0443 \u0438 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u0438\u0442\u044c \u043f\u0440\u0435\u0437\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0434\u043b\u044f \u0441\u0432\u043e\u0435\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u044b. \u0412\u0434\u043e\u0445\u043d\u043e\u0432\u0438\u0432\u0448\u0438\u0441\u044c \u0441\u043f\u0438\u043a\u0435\u0440\u043e\u043c \u0415\u0432\u0433\u0435\u043d\u0438\u0439 \u041c\u0430\u0440\u0435\u043d\u043a\u043e\u0432, \u044f \u0440\u0435\u0448\u0438\u043b \u0432\u044b\u0431\u0440\u0430\u0442\u044c \u0434\u0430\u043d\u043d\u0443\u044e \u0442\u0435\u043c\u0443. \u0412 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0435 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0438, \u044f \u043e\u0431\u043b\u0430\u0437\u0438\u043b \u043c\u043d\u043e\u0433\u043e \u0441\u0442\u0430\u0442\u0435\u0439 \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432 \u0447\u0442\u043e \u0431\u044b \u043a\u043e\u043c\u043f\u0430\u043a\u0442\u043d\u043e \u0438 \u044d\u0444\u0444\u0435\u043a\u0442\u0438\u0432\u043d\u043e \u0434\u043e\u043d\u0435\u0441\u0442\u0438 \u043d\u0443\u0436\u043d\u0443\u044e \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e.<\/p>\n<p>\u0421\u0435\u0439\u0447\u0430\u0441 \u0445\u043e\u0447\u0443 \u043f\u043e\u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u0435\u044e \u0432 \u043d\u0430\u0434\u0435\u0436\u0434\u0435, \u0447\u0442\u043e \u043a\u043e\u043c\u0443-\u0442\u043e \u043e\u043d\u0430 \u043f\u043e\u043c\u043e\u0436\u0435\u0442 \u0432 \u0438\u0437\u0443\u0447\u0435\u043d\u0438\u0435 Swagger (OpenApi 3.0)<\/p>\n<h2>\u0412\u0432\u0435\u0434\u0435\u043d\u0438\u0435<\/h2>\n<p>\u042f \u043d\u0430 99% \u0443\u0432\u0435\u0440\u0435\u043d \u0443 \u043c\u043d\u043e\u0433\u0438\u0445 \u0438\u0437 \u0432\u0430\u0441 \u0431\u044b\u043b\u0438 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u044b \u0441 \u043f\u043e\u0438\u0441\u043a\u043e\u043c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0434\u043b\u044f \u043d\u0443\u0436\u043d\u043e\u0433\u043e \u0432\u0430\u043c \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430. \u041c\u043d\u043e\u0433\u0438\u0435 \u0435\u0441\u043b\u0438 \u0438 \u043d\u0430\u0445\u043e\u0434\u0438\u043b\u0438 \u0435\u0435 \u0431\u044b\u0441\u0442\u0440\u043e, \u043d\u043e \u0432 \u043a\u043e\u043d\u0435\u0447\u043d\u043e\u043c \u0438\u0442\u043e\u0433\u0435 \u043e\u043a\u0430\u0437\u044b\u0432\u0430\u043b\u043e\u0441\u044c \u0447\u0442\u043e \u043e\u043d\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043d\u0435 \u0442\u0430\u043a \u043a\u0430\u043a \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u043b\u0438\u0431\u043e \u0432\u043e\u043e\u0431\u0449\u0435 \u0435\u0433\u043e \u0443\u0436\u0435 \u043d\u0435\u0442.<br \/>\u0421\u0435\u0433\u043e\u0434\u043d\u044f \u044f \u0432\u0430\u043c \u0434\u043e\u043a\u0430\u0436\u0443, \u0447\u0442\u043e \u0435\u0441\u0442\u044c \u0441\u043f\u043e\u0441\u043e\u0431\u044b \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u043c \u0432\u0438\u0434\u0435 \u0438 \u0432 \u044d\u0442\u043e\u043c \u043c\u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u043f\u043e\u043c\u043e\u0433\u0430\u0442\u044c Open Source framework \u043e\u0442 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 SmartBear \u043f\u043e\u0434 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435\u043c Swagger, \u0430 \u0441 2016 \u0433\u043e\u0434\u0430 \u043e\u043d \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u043d\u043e\u0432\u043e\u0435 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 \u0438 \u0441\u0442\u0430\u043b \u043d\u0430\u0437\u044b\u0432\u0430\u0442\u044c\u0441\u044f OpenAPI Specification.<\/p>\n<p><strong>Swagger<\/strong> &#8212; \u044d\u0442\u043e \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a \u0434\u043b\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 RESTful API. \u0415\u0433\u043e \u043f\u0440\u0435\u043b\u0435\u0441\u0442\u044c \u0437\u0430\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u043e\u043d \u0434\u0430\u0435\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0438\u043d\u0442\u0435\u0440\u0430\u043a\u0442\u0438\u0432\u043d\u043e \u043f\u0440\u043e\u0441\u043c\u0430\u0442\u0440\u0438\u0432\u0430\u0442\u044c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e, \u043d\u043e \u0438 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0442\u044c \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u2013 \u0442\u0430\u043a \u043d\u0430\u0437\u044b\u0432\u0430\u0435\u043c\u044b\u0439 Swagger UI.<\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0435\u043f\u043e\u0441\u0440\u0435\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0430 \u0438\u043b\u0438 \u0441\u0435\u0440\u0432\u0435\u0440 \u043f\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 API Swagger, \u0434\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u043f\u043e\u043d\u0430\u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f Swagger Codegen.<\/p>\n<h2>\u041e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u043f\u043e\u0434\u0445\u043e\u0434\u044b<\/h2>\n<p>Swagger \u0438\u043c\u0435\u0435\u0442 \u0434\u0432\u0430 \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u043a \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438:<\/p>\n<ul>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u043d\u0430 \u043e\u0441\u043d\u043e\u0432\u0430\u043d\u0438\u0438 \u0432\u0430\u0448\u0435\u0433\u043e \u043a\u043e\u0434\u0430. <\/p>\n<ul>\n<li>\n<p>\u0414\u0430\u043d\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a &#171;\u043e\u0447\u0435\u043d\u044c \u043f\u0440\u043e\u0441\u0442\u043e&#187;. \u041d\u0430\u043c \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442, \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0438 \u0443\u0436\u0435 \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0438\u043c\u0435\u0442\u044c \u043d\u0443\u0436\u043d\u0443\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e, \u0445\u043e\u0442\u044c \u0438 \u043d\u0435 \u043d\u0430\u0441\u0442\u043e\u043b\u044c\u043a\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0439 \u043a\u0430\u043a\u043e\u044e \u043c\u044b \u0445\u043e\u0442\u0435\u043b\u0438.<\/p>\n<\/li>\n<li>\n<p>\u041a\u043e\u0434 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c\u0441\u044f \u043d\u0435 \u043e\u0447\u0435\u043d\u044c \u0447\u0438\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u044b\u043c \u043e\u0442 \u043e\u0431\u0438\u043b\u0438\u044f \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0439 \u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u0432 \u043d\u0438\u0445.<\/p>\n<\/li>\n<li>\n<p>\u0412\u0441\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0431\u0443\u0434\u0435\u0442 \u0432\u043f\u0438\u0441\u0430\u043d\u0430 \u0432 \u043d\u0430\u0448\u0435\u043c \u043a\u043e\u0434\u0435 (\u0432\u0441\u0435 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u044b \u0438 \u043c\u043e\u0434\u0435\u043b\u0438 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u0432 \u043d\u0435\u043a\u0438\u0439 Java Swagger Code) <\/p>\n<\/li>\n<li>\n<p>\u041f\u043e\u0434\u0445\u043e\u0434 \u043d\u0435 \u0441\u043e\u0432\u0435\u0442\u0443\u044e\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c, \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438, \u043d\u043e \u0435\u0433\u043e \u043e\u0447\u0435\u043d\u044c \u043f\u0440\u043e\u0441\u0442\u043e \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043e\u0442 \u043a\u043e\u0434\u0430.<\/p>\n<ul>\n<li>\n<p>\u0414\u0430\u043d\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0437\u043d\u0430\u0442\u044c \u0441\u0438\u043d\u0442\u0430\u043a\u0441\u0438\u0441 Swagger Specification. <\/p>\n<\/li>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u043b\u0438\u0431\u043e \u0432 JAML\/JSON \u0444\u0430\u0439\u043b\u0435, \u043b\u0438\u0431\u043e \u0432 \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u0435 Swagger Editor.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>Swagger Tools<\/h2>\n<p>Swagger \u0438\u043b\u0438 OpenAPI framework \u0441\u043e\u0441\u0442\u043e\u0438\u0442 \u0438\u0437 4 \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0445 \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u043e\u0432:<\/p>\n<ol>\n<li>\n<p><strong> <\/strong><a href=\"https:\/\/github.com\/swagger-api\/swagger-core\" rel=\"noopener noreferrer nofollow\"><strong>Swagger Core<\/strong><\/a> &#8212; \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u043d\u0430 \u043e\u0441\u043d\u043e\u0432\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0433\u043e \u043a\u043e\u0434\u0430 \u043e\u0441\u043d\u043e\u0432\u044b\u0432\u0430\u044f\u0441\u044c \u043d\u0430 Java Annotation.<\/p>\n<\/li>\n<li>\n<p><a href=\"https:\/\/github.com\/swagger-api\/swagger-codegen\" rel=\"noopener noreferrer nofollow\"><strong>Swagger Codegen<\/strong><\/a> &#8212; \u043f\u043e\u0437\u0432\u043e\u043b\u0438\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 \u0434\u043b\u044f \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438.<\/p>\n<\/li>\n<li>\n<p><a href=\"https:\/\/github.com\/swagger-api\/swagger-ui\" rel=\"noopener noreferrer nofollow\"><strong>Swagger UI<\/strong><\/a> &#8212; \u043a\u0440\u0430\u0441\u0438\u0432\u044b\u0439 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e. \u0414\u0430\u0435\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043a\u0430\u043a\u0438\u0435 \u0442\u0438\u043f\u044b \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0435\u0441\u0442\u044c, \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043c\u043e\u0434\u0435\u043b\u0435\u0439 \u0438 \u0438\u0445 \u0442\u0438\u043f\u043e\u0432 \u0434\u0430\u043d\u043d\u044b\u0445.<\/p>\n<\/li>\n<li>\n<p><a href=\"https:\/\/github.com\/swagger-api\/swagger-editor\" rel=\"noopener noreferrer nofollow\"><strong>Swagger Editor<\/strong><\/a> &#8212; \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043f\u0438\u0441\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 YAML \u0438\u043b\u0438 JSON \u0444\u043e\u0440\u043c\u0430\u0442\u0430.<\/p>\n<\/li>\n<\/ol>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u0434\u0430\u0432\u0430\u0439\u0442\u0435 \u043f\u043e\u0433\u043e\u0432\u043e\u0440\u0438\u043c \u043e \u043a\u0430\u0436\u0434\u043e\u043c \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u0435 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e.<\/p>\n<h2>Swagger Core<\/h2>\n<p><strong>Swagger Code <\/strong>&#8212; \u044d\u0442\u043e Java-\u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI<\/p>\n<p>\u0414\u043b\u044f \u0442\u043e\u0433\u043e \u0447\u0442\u043e \u0431\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c Swagger Core \u0432\u043e \u0432\u0441\u0435 \u043e\u0440\u0443\u0434\u0438\u0435, \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f:<\/p>\n<ul>\n<li>\n<p>Java 8 \u0438\u043b\u0438 \u0431\u043e\u043b\u044c\u0448\u0435<\/p>\n<\/li>\n<li>\n<p>Apache Maven 3.0.3 \u0438\u043b\u0438 \u0431\u043e\u043b\u044c\u0448\u0435<\/p>\n<\/li>\n<li>\n<p>Jackson 2.4.5 \u0438\u043b\u0438 \u0431\u043e\u043b\u044c\u0448\u0435<\/p>\n<\/li>\n<\/ul>\n<p>\u0427\u0442\u043e \u0431\u044b \u0432\u043d\u0435\u0434\u0440\u0438\u0442\u044c \u0435\u0433\u043e \u0432 \u043f\u0440\u043e\u0435\u043a\u0442, \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0434\u0432\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438:<\/p>\n<pre><code class=\"java\">&lt;dependency&gt;     &lt;groupId&gt;io.swagger.core.v3&lt;\/groupId&gt;     &lt;artifactId&gt;swagger-annotations&lt;\/artifactId&gt;     &lt;version&gt;2.1.6&lt;\/version&gt; &lt;\/dependency&gt; &lt;dependency&gt;     &lt;groupId&gt;org.springdoc&lt;\/groupId&gt;     &lt;artifactId&gt;springdoc-openapi-ui&lt;\/artifactId&gt;     &lt;version&gt;1.5.2&lt;\/version&gt; &lt;\/dependency&gt;<\/code><\/pre>\n<p>\u0422\u0430\u043a\u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c maven \u043f\u043b\u0430\u0433\u0438\u043d, \u0447\u0442\u043e \u0431\u044b \u043d\u0430\u0448\u0430 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0440\u0438 \u0441\u0431\u043e\u0440\u043a\u0435 \u043f\u0440\u043e\u0435\u043a\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043b\u0441\u044c \u0432 YAML<\/p>\n<pre><code class=\"java\">&lt;plugin&gt;  &lt;groupId&gt;org.springdoc&lt;\/groupId&gt;  &lt;artifactId&gt;springdoc-openapi-maven-plugin&lt;\/artifactId&gt;  &lt;version&gt;0.3&lt;\/version&gt;  &lt;executions&gt;    &lt;execution&gt;    &lt;phase&gt;integration-test&lt;\/phase&gt;    &lt;goals&gt;      &lt;goal&gt;generate&lt;\/goal&gt;    &lt;\/goals&gt;    &lt;\/execution&gt;  &lt;\/executions&gt;  &lt;configuration&gt;    &lt;apiDocsUrl&gt;http:\/\/localhost:8080\/v3\/api-docs&lt;\/apiDocsUrl&gt;    &lt;outputFileName&gt;openapi.yaml&lt;\/outputFileName&gt;    &lt;outputDir&gt;${project.build.directory}&lt;\/outputDir&gt;  &lt;\/configuration&gt; &lt;\/plugin&gt;<\/code><\/pre>\n<p>\u0414\u0430\u043b\u044c\u0448\u0435 \u043d\u0430\u043c \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043a\u043e\u043d\u0444\u0438\u0433 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442. <\/p>\n<p>\u0414\u043b\u044f \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 Swagger \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0434\u0432\u0430 \u0431\u0438\u043d\u0430. \u0413\u0434\u0435 \u043d\u0430\u043c \u043d\u0443\u0436\u043d\u043e \u0431\u0443\u0434\u0435\u0442 \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f, \u0432\u0435\u0440\u0441\u0438\u044e \u043d\u0430\u0448\u0435\u0433\u043e API, \u0442\u0430\u043a \u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043a\u043e\u043d\u0442\u0430\u043a\u0442 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u0437\u0430 \u0434\u0430\u043d\u043d\u044b\u0435 API<\/p>\n<pre><code class=\"java\">    @Bean     public GroupedOpenApi publicUserApi() {         return GroupedOpenApi.builder()                              .group(\"Users\")                              .pathsToMatch(\"\/users\/**\")                              .build();     }      @Bean     public OpenAPI customOpenApi(@Value(\"${application-description}\")String appDescription,                                  @Value(\"${application-version}\")String appVersion) {         return new OpenAPI().info(new Info().title(\"Application API\")                                             .version(appVersion)                                             .description(appDescription)                                             .license(new License().name(\"Apache 2.0\")                                                                   .url(\"http:\/\/springdoc.org\"))                                             .contact(new Contact().name(\"username\")                                                                   .email(\"test@gmail.com\")))                             .servers(List.of(new Server().url(\"http:\/\/localhost:8080\")                                                          .description(\"Dev service\"),                                              new Server().url(\"http:\/\/localhost:8082\")                                                          .description(\"Beta service\")));     }<\/code><\/pre>\n<p>\u041f\u043e\u0441\u043b\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u043d\u0443\u0436\u043d\u044b\u0445 \u043d\u0430\u043c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439, \u0443 \u043d\u0430\u0441 \u043f\u043e\u044f\u0432\u044f\u0442\u0441\u044f \u043d\u043e\u0432\u044b\u0435 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0430\u0448 \u043a\u043e\u0434.<\/p>\n<p>\u0412\u043e\u0442 \u043d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0438\u0437 \u043d\u0438\u0445:<\/p>\n<ul>\n<li>\n<p><strong> @Operation<\/strong> &#8212; \u041e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044e \u0438\u043b\u0438 \u043e\u0431\u044b\u0447\u043d\u043e \u043c\u0435\u0442\u043e\u0434 HTTP \u0434\u043b\u044f \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u043d\u043e\u0433\u043e \u043f\u0443\u0442\u0438.<\/p>\n<\/li>\n<li>\n<p><strong>@Parameter <\/strong>&#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043e\u0434\u0438\u043d \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u0432 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 OpenAPI.<\/p>\n<\/li>\n<li>\n<p><strong>@RequestBody<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0442\u0435\u043b\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u0432 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438<\/p>\n<\/li>\n<li>\n<p><strong>@ApiResponse<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043e\u0442\u0432\u0435\u0442 \u0432 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438<\/p>\n<\/li>\n<li>\n<p><strong>@Tag<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0442\u0435\u0433\u0438 \u0434\u043b\u044f \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 \u0438\u043b\u0438 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f OpenAPI.<\/p>\n<\/li>\n<li>\n<p><strong>@Server<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0441\u0435\u0440\u0432\u0435\u0440\u044b \u0434\u043b\u044f \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 \u0438\u043b\u0438 \u0434\u043b\u044f \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f OpenAPI.<\/p>\n<\/li>\n<li>\n<p><strong>@Callback<\/strong> &#8212; \u041e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u043d\u0430\u0431\u043e\u0440 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432<\/p>\n<\/li>\n<li>\n<p><strong>@Link<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u0443\u044e \u0441\u0441\u044b\u043b\u043a\u0443 \u0432\u0440\u0435\u043c\u0435\u043d\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0434\u043b\u044f \u043e\u0442\u0432\u0435\u0442\u0430.<\/p>\n<\/li>\n<li>\n<p><strong>@Schema<\/strong> &#8212; \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0442\u044c \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u0438 \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435.<\/p>\n<\/li>\n<li>\n<p><strong>@ArraySchema<\/strong> &#8212; \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0442\u044c \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u0438 \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435 \u0434\u043b\u044f \u0442\u0438\u043f\u043e\u0432 \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u0432.<\/p>\n<\/li>\n<li>\n<p><strong>@Content <\/strong>&#8212; \u041f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0441\u0445\u0435\u043c\u0443 \u0438 \u043f\u0440\u0438\u043c\u0435\u0440\u044b \u0434\u043b\u044f \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u043d\u043e\u0433\u043e \u0442\u0438\u043f\u0430 \u043c\u0443\u043b\u044c\u0442\u0438\u043c\u0435\u0434\u0438\u0430.<\/p>\n<\/li>\n<li>\n<p><strong>@Hidden<\/strong> &#8212; \u0421\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0440\u0435\u0441\u0443\u0440\u0441, \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044e \u0438\u043b\u0438 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e<\/p>\n<\/li>\n<\/ul>\n<p>\u041f\u0440\u0438\u043c\u0435\u0440\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f:<\/p>\n<pre><code class=\"java\">@Tag(name = \"User\", description = \"The User API\") @RestController public class UserController {}<\/code><\/pre>\n<pre><code class=\"java\">    @Operation(summary = \"Gets all users\", tags = \"user\")     @ApiResponses(value = {             @ApiResponse(                     responseCode = \"200\",                     description = \"Found the users\",                     content = {                             @Content(                                     mediaType = \"application\/json\",                                     array = @ArraySchema(schema = @Schema(implementation = UserApi.class)))                     })     })     @GetMapping(\"\/users\")     public List&lt;UserApi&gt; getUsers()<\/code><\/pre>\n<h2>Swagger Codegen <\/h2>\n<p><strong>Swagger Codegen <\/strong>&#8212; \u044d\u0442\u043e \u043f\u0440\u043e\u0435\u043a\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0441\u043e\u0437\u0434\u0430\u0432\u0430\u0442\u044c \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 API (\u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0435 SDK), \u0437\u0430\u0433\u043b\u0443\u0448\u043a\u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0441 \u0443\u0447\u0435\u0442\u043e\u043c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI.<\/p>\n<p>\u0412 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0435 \u0432\u0440\u0435\u043c\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u044f\u0437\u044b\u043a\u0438 \/ \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0438:<\/p>\n<ul>\n<li>\n<p>API clients:<\/p>\n<ul>\n<li>\n<p>Java (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured)<\/p>\n<\/li>\n<li>\n<p>Kotlin<\/p>\n<\/li>\n<li>\n<p>Scala (akka, http4s, swagger-async-httpclient)<\/p>\n<\/li>\n<li>\n<p>Groovy<\/p>\n<\/li>\n<li>\n<p>Node.js (ES5, ES6, AngularJS with Google Closure Compiler annotations)<\/p>\n<\/li>\n<li>\n<p>Haskell (http-client, Servant)<\/p>\n<\/li>\n<li>\n<p>C# (.net 2.0, 3.5 or later)<\/p>\n<\/li>\n<li>\n<p>C++ (cpprest, Qt5, Tizen)<\/p>\n<\/li>\n<li>\n<p>Bash<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Server stub:<\/p>\n<ul>\n<li>\n<p>Java (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, RestEasy, Play Framework, <a href=\"https:\/\/github.com\/ProKarma-Inc\/pkmst-getting-started-examples\" rel=\"noopener noreferrer nofollow\">PKMST<\/a>)<\/p>\n<\/li>\n<li>\n<p>Kotlin<\/p>\n<\/li>\n<li>\n<p>C# (ASP.NET Core, NancyFx)<\/p>\n<\/li>\n<li>\n<p>C++ (Pistache, Restbed)<\/p>\n<\/li>\n<li>\n<p>Haskell (Servant)<\/p>\n<\/li>\n<li>\n<p>PHP (Lumen, Slim, Silex, <a href=\"https:\/\/symfony.com\/\" rel=\"noopener noreferrer nofollow\">Symfony<\/a>, <a href=\"https:\/\/github.com\/zendframework\/zend-expressive\" rel=\"noopener noreferrer nofollow\">Zend Expressive<\/a>)<\/p>\n<\/li>\n<li>\n<p>Python (Flask)<\/p>\n<\/li>\n<li>\n<p>NodeJS<\/p>\n<\/li>\n<li>\n<p>Ruby (Sinatra, Rails5)<\/p>\n<\/li>\n<li>\n<p>Rust (rust-server)<\/p>\n<\/li>\n<li>\n<p>Scala (<a href=\"https:\/\/github.com\/finagle\/finch\" rel=\"noopener noreferrer nofollow\">Finch<\/a>, <a href=\"https:\/\/github.com\/lagom\/lagom\" rel=\"noopener noreferrer nofollow\">Lagom<\/a>, Scalatra)<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>API documentation generators:<\/p>\n<ul>\n<li>\n<p>HTML<\/p>\n<\/li>\n<li>\n<p>Confluence Wiki<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Other:<\/p>\n<ul>\n<li>\n<p>JMeter<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>\u0427\u0442\u043e \u0431\u044b \u0432\u043d\u0435\u0434\u0440\u0438\u0442\u044c \u0435\u0433\u043e \u0432 \u043f\u0440\u043e\u0435\u043a\u0442, \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044c, \u0435\u0441\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435 Swagger:<\/p>\n<pre><code class=\"java\">&lt;dependency&gt;     &lt;groupId&gt;io.swagger&lt;\/groupId&gt;     &lt;artifactId&gt;swagger-codegen-maven-plugin&lt;\/artifactId&gt;     &lt;version&gt;2.4.18&lt;\/version&gt; &lt;\/dependency&gt;<\/code><\/pre>\n<p>\u0438 \u0435\u0441\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435 OpenApi 3.0, \u0442\u043e:<\/p>\n<pre><code class=\"java\">&lt;dependency&gt;     &lt;groupId&gt;io.swagger.codegen.v3&lt;\/groupId&gt;     &lt;artifactId&gt;swagger-codegen-maven-plugin&lt;\/artifactId&gt;     &lt;version&gt;3.0.24&lt;\/version&gt; &lt;\/dependency&gt;<\/code><\/pre>\n<p>\u041c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c maven \u043f\u043b\u0430\u0433\u0438\u043d, \u0438 \u0443\u0436\u0435 \u043d\u0430 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0435 \u0441\u0431\u043e\u0440\u043a\u0438 \u043c\u044b \u043c\u043e\u0436\u0435\u043c \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0443\u0436\u043d\u044b\u0439 \u0434\u043b\u044f \u043d\u0430\u0441 \u043a\u043b\u0438\u0435\u043d\u0442 \u043b\u0438\u0431\u043e \u043c\u043e\u043a \u0441\u0435\u0440\u0432\u0438\u0441\u0430.<\/p>\n<pre><code class=\"java\">      &lt;plugin&gt;         &lt;groupId&gt;org.openapitools&lt;\/groupId&gt;         &lt;artifactId&gt;openapi-generator-maven-plugin&lt;\/artifactId&gt;         &lt;version&gt;3.3.4&lt;\/version&gt;         &lt;executions&gt;           &lt;execution&gt;             &lt;phase&gt;compile&lt;\/phase&gt;             &lt;goals&gt;               &lt;goal&gt;generate&lt;\/goal&gt;             &lt;\/goals&gt;             &lt;configuration&gt;               &lt;generatorName&gt;spring&lt;\/generatorName&gt;               &lt;inputSpec&gt;${project.basedir}\/src\/main\/resources\/api.yaml&lt;\/inputSpec&gt;               &lt;output&gt;${project.build.directory}\/generated-sources&lt;\/output&gt;               &lt;apiPackage&gt;com.api&lt;\/apiPackage&gt;               &lt;modelPackage&gt;com.model&lt;\/modelPackage&gt;               &lt;supportingFilesToGenerate&gt;                 ApiUtil.java               &lt;\/supportingFilesToGenerate&gt;               &lt;configOptions&gt;                 &lt;groupId&gt;${project.groupId}&lt;\/groupId&gt;                 &lt;artifactId&gt;${project.artifactId}&lt;\/artifactId&gt;                 &lt;artifactVersion&gt;${project.version}&lt;\/artifactVersion&gt;                 &lt;delegatePattern&gt;true&lt;\/delegatePattern&gt;                 &lt;sourceFolder&gt;swagger&lt;\/sourceFolder&gt;                 &lt;library&gt;spring-mvc&lt;\/library&gt;                 &lt;interfaceOnly&gt;true&lt;\/interfaceOnly&gt;                 &lt;useBeanValidation&gt;true&lt;\/useBeanValidation&gt;                 &lt;dateLibrary&gt;java8&lt;\/dateLibrary&gt;                 &lt;java8&gt;true&lt;\/java8&gt;               &lt;\/configOptions&gt;               &lt;ignoreFileOverride&gt;${project.basedir}\/.openapi-generator-ignore&lt;\/ignoreFileOverride&gt;             &lt;\/configuration&gt;           &lt;\/execution&gt;         &lt;\/executions&gt;       &lt;\/plugin&gt;<\/code><\/pre>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0432\u0441\u0435 \u044d\u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0432\u044b\u043f\u043e\u043b\u043d\u0438\u0442\u044c \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u043a\u043e\u043c\u0430\u043d\u0434\u043d\u043e\u0439 \u0441\u0442\u0440\u043e\u043a\u0438. <\/p>\n<p>\u0417\u0430\u043f\u0443\u0441\u0442\u0438\u0432 \u0434\u0436\u0430\u0440\u043d\u0438\u043a codegen \u0438 \u0437\u0430\u0434\u0430\u0432 \u043a\u043e\u043c\u0430\u043d\u0434\u0443 <strong>help <\/strong>\u043c\u043e\u0436\u043d\u043e \u0443\u0432\u0438\u0434\u0435\u0442\u044c \u043a\u043e\u043c\u0430\u043d\u0434\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043d\u0430\u043c <strong>Swagger Codegen<\/strong>:<\/p>\n<ul>\n<li>\n<p><strong>config-help<\/strong> &#8212; \u0421\u043f\u0440\u0430\u0432\u043a\u0430 \u043f\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0435 \u0434\u043b\u044f \u0432\u044b\u0431\u0440\u0430\u043d\u043d\u043e\u0433\u043e \u044f\u0437\u044b\u043a\u0430<\/p>\n<\/li>\n<li>\n<p><strong>generate <\/strong>&#8212; \u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043e\u0434 \u0441 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u043c \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u043e\u043c<\/p>\n<\/li>\n<li>\n<p><strong>help <\/strong>&#8212; \u041e\u0442\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u043e\u0439 \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u0438 \u043e\u0431 openapi-generator<\/p>\n<\/li>\n<li>\n<p><strong>list <\/strong>&#8212; \u041f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u044f\u0435\u0442 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b\u0435 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u044b<\/p>\n<\/li>\n<li>\n<p><strong>meta <\/strong>&#8212; \u0413\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u0434\u043b\u044f \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u043d\u043e\u0432\u043e\u0433\u043e \u043d\u0430\u0431\u043e\u0440\u0430 \u0448\u0430\u0431\u043b\u043e\u043d\u043e\u0432 \u0438 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 \u0434\u043b\u044f Codegen. \u0412\u044b\u0432\u043e\u0434 \u0431\u0443\u0434\u0435\u0442 \u043e\u0441\u043d\u043e\u0432\u0430\u043d \u043d\u0430 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u043e\u043c \u0432\u0430\u043c\u0438 \u044f\u0437\u044b\u043a\u0435 \u0438 \u0431\u0443\u0434\u0435\u0442 \u0432\u043a\u043b\u044e\u0447\u0430\u0442\u044c \u0448\u0430\u0431\u043b\u043e\u043d\u044b \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e.<\/p>\n<\/li>\n<li>\n<p><strong>validate <\/strong>&#8212; \u041f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e<\/p>\n<\/li>\n<li>\n<p><strong>version <\/strong>&#8212; \u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u043e \u0432\u0435\u0440\u0441\u0438\u0438, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u0443\u044e \u0432 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430\u0445<\/p>\n<\/li>\n<\/ul>\n<p>\u0414\u043b\u044f \u043d\u0430\u0441 \u0441\u0430\u043c\u044b\u0435 \u043d\u0443\u0436\u043d\u044b\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u044d\u0442\u043e <strong>validate, <\/strong>\u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0431\u044b\u0441\u0442\u0440\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u043d\u0430 \u0432\u0430\u043b\u0438\u0434\u043d\u043e\u0441\u0442\u044c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0438 <strong>generate,<\/strong>&nbsp;\u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043c\u044b \u043c\u043e\u0436\u0435\u043c \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c <strong>Client <\/strong>\u043d\u0430 \u044f\u0437\u044b\u043a\u0435 <strong>Java<\/strong><\/p>\n<ul>\n<li>\n<p>java -jar openapi-generator-cli-4.3.1.jar validate -i openapi.yaml<\/p>\n<\/li>\n<li>\n<p>&nbsp;java -jar openapi-generator-cli-4.3.1.jar generate -i openapi.yaml -g java &#8212;library jersey2 -o client-gener-new<\/p>\n<\/li>\n<\/ul>\n<h2>Swagger UI<\/h2>\n<p><strong>Swagger UI<\/strong> &#8212; \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0432\u0438\u0437\u0443\u0430\u043b\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0440\u0435\u0441\u0443\u0440\u0441\u044b API \u0438 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u0441 \u043d\u0438\u043c\u0438 \u0431\u0435\u0437 \u043a\u0430\u043a\u043e\u0439-\u043b\u0438\u0431\u043e \u043b\u043e\u0433\u0438\u043a\u0438 \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0438. \u041e\u043d \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0438\u0437 \u0432\u0430\u0448\u0435\u0439 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI (\u0440\u0430\u043d\u0435\u0435 \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u043e\u0439 \u043a\u0430\u043a Swagger), \u0430 \u0432\u0438\u0437\u0443\u0430\u043b\u044c\u043d\u0430\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0443\u043f\u0440\u043e\u0449\u0430\u0435\u0442 \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u044e\u044e \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044e \u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 \u043a\u043b\u0438\u0435\u043d\u0442\u0430. <\/p>\n<p>\u0412\u043e\u0442 \u043f\u0440\u0438\u043c\u0435\u0440 Swagger UI \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u0438\u0437\u0443\u0430\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0434\u043b\u044f \u043c\u043e\u0435\u0433\u043e pet-project:<\/p>\n<figure class=\"full-width\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/upload_files\/88b\/c9f\/0f9\/88bc9f0f900b59774d74a79249b4ae80.png\" width=\"1455\" height=\"780\"><figcaption><\/figcaption><\/figure>\n<figure class=\"full-width\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/upload_files\/3d6\/265\/2d8\/3d62652d8f4a89d0e19297d3e22c1f1b.png\" width=\"1427\" height=\"640\"><figcaption><\/figcaption><\/figure>\n<p>\u041d\u0430\u0436\u0430\u0432\u0448\u0438 \u043d\u0430 \u043a\u043d\u043e\u043f\u043a\u0443 &#171;Try it out&#187;, \u043c\u044b \u043c\u043e\u0436\u0435\u043c \u0432\u044b\u043f\u043e\u043b\u043d\u0438\u0442\u044c \u0437\u0430\u043f\u0440\u043e\u0441 \u0437\u0430 \u0441\u0435\u0440\u0432\u0435\u0440 \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043e\u0442\u0432\u0435\u0442 \u043e\u0442 \u043d\u0435\u0433\u043e:<\/p>\n<figure class=\"full-width\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/upload_files\/145\/ff6\/1eb\/145ff61ebc5841671232e78dc9b02ba6.png\" width=\"1419\" height=\"747\"><figcaption><\/figcaption><\/figure>\n<h2>Swagger Editor<\/h2>\n<p><strong>Swagger Editor<\/strong> &#8212; \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0440\u0435\u0434\u0430\u043a\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 <strong>Swagger API<\/strong> \u0432 <strong>YAML <\/strong>\u0432\u043d\u0443\u0442\u0440\u0438 \u0432\u0430\u0448\u0435\u0433\u043e \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430 \u0438 \u043f\u0440\u043e\u0441\u043c\u0430\u0442\u0440\u0438\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 \u0440\u0435\u0436\u0438\u043c\u0435 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0438. \u0417\u0430\u0442\u0435\u043c \u043c\u043e\u0436\u043d\u043e \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u043f\u0443\u0441\u0442\u0438\u043c\u044b\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f <strong>Swagger JSON<\/strong> \u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0438\u0445 \u0441 \u043f\u043e\u043b\u043d\u044b\u043c \u043d\u0430\u0431\u043e\u0440\u043e\u043c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432 <strong>Swagger <\/strong>(\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u043a\u043e\u0434\u0430, \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0438 \u0442. \u0414.). <\/p>\n<p>\u041d\u0430 \u0432\u0435\u0440\u0445\u043d\u0435\u043c \u0443\u0440\u043e\u0432\u043d\u0435 \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI 3.0 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u0432\u043e\u0441\u0435\u043c\u044c \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432. \u0412\u043d\u0443\u0442\u0440\u0438 \u044d\u0442\u0438\u0445 \u0432\u0435\u0440\u0445\u043d\u0435\u0443\u0440\u043e\u0432\u043d\u0435\u0432\u044b\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0435\u0441\u0442\u044c \u043c\u043d\u043e\u0433\u043e \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u043d\u043e \u043d\u0430 \u0432\u0435\u0440\u0445\u043d\u0435\u043c \u0443\u0440\u043e\u0432\u043d\u0435 \u0435\u0441\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u043e\u0431\u044a\u0435\u043a\u0442\u044b:<\/p>\n<ol>\n<li>\n<p>openapi<\/p>\n<\/li>\n<li>\n<p>info<\/p>\n<\/li>\n<li>\n<p>servers<\/p>\n<\/li>\n<li>\n<p>paths<\/p>\n<\/li>\n<li>\n<p>components<\/p>\n<\/li>\n<li>\n<p>security<\/p>\n<\/li>\n<li>\n<p>tags<\/p>\n<\/li>\n<li>\n<p>externalDocs<\/p>\n<\/li>\n<\/ol>\n<p>\u0414\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u043d\u0430\u0434 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u0441\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0435\u0439 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f <a href=\"https:\/\/swagger.io\/tools\/swagger-editor\/\" rel=\"noopener noreferrer nofollow\">\u043e\u043d\u043b\u0430\u0439\u043d-\u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 Swagger<\/a> \u0420\u0435\u0434\u0430\u043a\u0442\u043e\u0440 Swagger \u0438\u043c\u0435\u0435\u0442 \u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u043d\u043e\u0435 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u0438\u0435: \u0441\u043b\u0435\u0432\u0430 \u043f\u0438\u0448\u0435\u043c \u043a\u043e\u0434 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0430 \u0441\u043f\u0440\u0430\u0432\u0430 \u0432\u0438\u0434\u0438\u043c \u043f\u043e\u043b\u043d\u043e\u0444\u0443\u043d\u043a\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 \u0434\u0438\u0441\u043f\u043b\u0435\u0439 Swagger UI. \u041c\u043e\u0436\u043d\u043e \u0434\u0430\u0436\u0435 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0442\u044c \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u0438\u0437 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u0430 Swagger \u0432 \u044d\u0442\u043e\u043c \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u0435.<\/p>\n<p>\u0420\u0435\u0434\u0430\u043a\u0442\u043e\u0440 Swagger \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442 \u043a\u043e\u043d\u0442\u0435\u043d\u0442 \u0432 \u0440\u0435\u0436\u0438\u043c\u0435 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0438, \u0438 \u0443\u043a\u0430\u0436\u0435\u0442 \u043e\u0448\u0438\u0431\u043a\u0438 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438, \u0432\u043e \u0432\u0440\u0435\u043c\u044f \u043a\u043e\u0434\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438. \u041d\u0435 \u0441\u0442\u043e\u0438\u0442 \u0431\u0435\u0441\u043f\u043e\u043a\u043e\u0438\u0442\u044c\u0441\u044f \u043e\u0431 \u043e\u0448\u0438\u0431\u043a\u0430\u0445, \u0435\u0441\u043b\u0438 \u043e\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0442 X-\u043c\u0435\u0442\u043a\u0438 \u0432 \u043a\u043e\u0434\u0435, \u043d\u0430\u0434 \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u0438\u0434\u0435\u0442 \u0440\u0430\u0431\u043e\u0442\u0430.<\/p>\n<p>\u041f\u0435\u0440\u0432\u044b\u043c \u0438 \u0432\u0430\u0436\u043d\u044b\u043c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e\u043c \u0434\u043b\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u044d\u0442\u043e <strong>openapi<\/strong>. \u0412 \u043e\u0431\u044a\u0435\u043a\u0442\u0435 \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0432\u0435\u0440\u0441\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI. \u0414\u043b\u044f Swagger \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u044d\u0442\u043e \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e \u0431\u0443\u0434\u0435\u0442 swagger:<\/p>\n<pre><code> openapi: \"3.0.2\"<\/code><\/pre>\n<\/p>\n<p>\u041e\u0431\u044a\u0435\u043a\u0442 <strong>info<\/strong> \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043e\u0441\u043d\u043e\u0432\u043d\u0443\u044e \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u043e \u0432\u0430\u0448\u0435\u043c API,\u0432\u043a\u043b\u044e\u0447\u0430\u044f \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a, \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435, \u0432\u0435\u0440\u0441\u0438\u044e, \u0441\u0441\u044b\u043b\u043a\u0443 \u043d\u0430 \u043b\u0438\u0446\u0435\u043d\u0437\u0438\u044e, \u0441\u0441\u044b\u043b\u043a\u0443 \u043d\u0430 \u043e\u0431\u0441\u043b\u0443\u0436\u0438\u0432\u0430\u043d\u0438\u044f \u0438 \u043a\u043e\u043d\u0442\u0430\u043a\u0442\u043d\u0443\u044e \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e. \u041c\u043d\u043e\u0433\u0438\u0435 \u0438\u0437 \u044d\u0442\u0438\u0445 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e \u044f\u0432\u043b\u044f\u044e\u0442\u0441\u044f \u043d\u0435 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u043c\u0438.<\/p>\n<pre><code>info:   title: \"OpenWeatherMap API\"   description: \"Get the current weather, daily forecast for 16 days, and a three-hour-interval forecast for 5 days for your city.\"   version: \"2.5\"   termsOfService: \"https:\/\/openweathermap.org\/terms\"   contact:   \tname: \"OpenWeatherMap API\"     url: \"https:\/\/openweathermap.org\/api\"     email: \"some_email@gmail.com\"   license:     name: \"CC Attribution-ShareAlike 4.0 (CC BY-SA 4.0)\"     url: \"https:\/\/openweathermap.org\/price\"<\/code><\/pre>\n<p>\u041e\u0431\u044a\u0435\u043a\u0442 <strong>servers<\/strong> \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u0431\u0430\u0437\u043e\u0432\u044b\u0439 \u043f\u0443\u0442\u044c, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u044b\u0439 \u0432 \u0432\u0430\u0448\u0438\u0445 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u0445 API. \u0411\u0430\u0437\u043e\u0432\u044b\u0439 \u043f\u0443\u0442\u044c &#8212; \u044d\u0442\u043e \u0447\u0430\u0441\u0442\u044c URL, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043f\u0435\u0440\u0435\u0434 \u043a\u043e\u043d\u0435\u0447\u043d\u043e\u0439 \u0442\u043e\u0447\u043a\u043e\u0439. \u041e\u0431\u044a\u0435\u043a\u0442 <strong>servers<\/strong> \u043e\u0431\u043b\u0430\u0434\u0430\u0435\u0442 \u0433\u0438\u0431\u043a\u043e\u0439 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u043e\u0439. \u041c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e URL-\u0430\u0434\u0440\u0435\u0441\u043e\u0432:<\/p>\n<pre><code>servers:   - url: https:\/\/api.openweathermap.org\/data\/2.5\/         description: Production server   - url: http:\/\/beta.api.openweathermap.org\/data\/2.5\/         description: Beta server   - url: http:\/\/some-other.api.openweathermap.org\/data\/2.5\/         description: Some other server<\/code><\/pre>\n<p><strong>paths <\/strong>&#8212; \u042d\u0442\u043e \u0442\u0430 \u0436\u0435 \u201c\u043a\u043e\u043d\u0435\u0447\u043d\u0430\u044f \u0442\u043e\u0447\u043a\u0430\u201d \u0432 \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0438\u0438 \u0441 \u0442\u0435\u0440\u043c\u0438\u043d\u043e\u043b\u043e\u0433\u0438\u0438 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI. \u041a\u0430\u0436\u0434\u044b\u0439 \u043e\u0431\u044a\u0435\u043a\u0442 path \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043e\u0431\u044a\u0435\u043a\u0442 operations &#8212; \u044d\u0442\u043e \u043c\u0435\u0442\u043e\u0434\u044b GET, POST, PUT, DELETE:<\/p>\n<pre><code>paths:   \/weather:      get:<\/code><\/pre>\n<p>\u041e\u0431\u044a\u0435\u043a\u0442 <strong>components <\/strong>\u0443\u043d\u0438\u043a\u0430\u043b\u0435\u043d \u0441\u0440\u0435\u0434\u0438 \u0434\u0440\u0443\u0433\u0438\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 <strong>OpenAPI<\/strong>. \u0412 components \u0445\u0440\u0430\u043d\u044f\u0442\u0441\u044f \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u044b\u0435 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043c\u043e\u0433\u0443\u0442 \u043f\u043e\u044f\u0432\u043b\u044f\u0442\u044c\u0441\u044f \u0432 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043c\u0435\u0441\u0442\u0430\u0445 \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0435 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438. \u0412 \u043d\u0430\u0448\u0435\u043c \u0441\u0446\u0435\u043d\u0430\u0440\u0438\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 API \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0445\u0440\u0430\u043d\u0438\u0442\u044c \u0434\u0435\u0442\u0430\u043b\u0438 \u0434\u043b\u044f \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 <strong>parameters <\/strong>\u0438 <strong>responses <\/strong>\u0432 \u043e\u0431\u044a\u0435\u043a\u0442\u0435 <strong>components<\/strong><\/p>\n<h2>Conclusions<\/h2>\n<ul>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0441\u0442\u0430\u043b\u0430 \u0431\u043e\u043b\u0435\u0435 \u043f\u043e\u043d\u044f\u0442\u043d\u0435\u0439 \u0434\u043b\u044f \u0431\u0438\u0437\u043d\u0435\u0441 \u044e\u0437\u0435\u0440\u0430 \u0442\u0430\u043a \u0438 \u0434\u043b\u044f \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u043c \u044e\u0437\u0435\u0440\u0430\u043c (Swagger UI, Open Specifiation)<\/p>\n<\/li>\n<li>\n<p>\u041c\u043e\u0436\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043e\u0434 \u0434\u043b\u044f Java, PHP, .NET, JavaScrypt (Swager Editor, Swagger Codegen)<\/p>\n<\/li>\n<li>\n<p>\u041c\u043e\u0436\u043d\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u044b \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f. \u041c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0442\u044c \u044d\u0442\u043e \u0432 \u0434\u0436\u0435\u043d\u043a\u0438\u043d\u0441\u0435 <\/p>\n<\/li>\n<li>\n<p>\u041d\u0435\u0442 \u043d\u0438 \u043a\u0430\u043a\u043e\u0439 \u043b\u0438\u0448\u043d\u0435\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043a \u043a\u043e\u0434\u0435, \u043a\u043e\u0434 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e, \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e<\/p>\n<\/li>\n<\/ul>\n<\/div>\n<p> \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/post\/541592\/\"> https:\/\/habr.com\/ru\/post\/541592\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"\n<div class=\"post__text post__text_v2\" id=\"post-content-body\">\n<p>\u0412\u0441\u0435\u043c \u043f\u0440\u0438\u0432\u0435\u0442!!! \u042d\u0442\u043e \u043c\u043e\u0439 \u043f\u0435\u0440\u0432\u044b\u0439 \u043f\u043e\u0441\u0442 \u043d\u0430 \u0425\u0430\u0431\u0440\u0435 \u0438 \u044f \u0445\u043e\u0447\u0443 \u043f\u043e\u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u0441 \u0432\u0430\u043c\u0438 \u0441\u0432\u043e\u0438\u043c \u043e\u043f\u044b\u0442\u043e\u043c \u0432 \u0438\u0441\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435 \u043d\u043e\u0432\u043e\u0433\u043e \u0434\u043b\u044f \u0441\u0435\u0431\u044f \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0430. <\/p>\n<p>\u041c\u043d\u0435 \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u0438\u043b\u0441\u044f \u043c\u043e\u043c\u0435\u043d\u0442 \u0432\u044b\u0431\u0440\u0430\u0442\u044c \u0442\u0435\u043c\u0443 \u0438 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u0438\u0442\u044c \u043f\u0440\u0435\u0437\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0434\u043b\u044f \u0441\u0432\u043e\u0435\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u044b. \u0412\u0434\u043e\u0445\u043d\u043e\u0432\u0438\u0432\u0448\u0438\u0441\u044c \u0441\u043f\u0438\u043a\u0435\u0440\u043e\u043c \u0415\u0432\u0433\u0435\u043d\u0438\u0439 \u041c\u0430\u0440\u0435\u043d\u043a\u043e\u0432, \u044f \u0440\u0435\u0448\u0438\u043b \u0432\u044b\u0431\u0440\u0430\u0442\u044c \u0434\u0430\u043d\u043d\u0443\u044e \u0442\u0435\u043c\u0443. \u0412 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0435 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0438, \u044f \u043e\u0431\u043b\u0430\u0437\u0438\u043b \u043c\u043d\u043e\u0433\u043e \u0441\u0442\u0430\u0442\u0435\u0439 \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432 \u0447\u0442\u043e \u0431\u044b \u043a\u043e\u043c\u043f\u0430\u043a\u0442\u043d\u043e \u0438 \u044d\u0444\u0444\u0435\u043a\u0442\u0438\u0432\u043d\u043e \u0434\u043e\u043d\u0435\u0441\u0442\u0438 \u043d\u0443\u0436\u043d\u0443\u044e \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e.<\/p>\n<p>\u0421\u0435\u0439\u0447\u0430\u0441 \u0445\u043e\u0447\u0443 \u043f\u043e\u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u0435\u044e \u0432 \u043d\u0430\u0434\u0435\u0436\u0434\u0435, \u0447\u0442\u043e \u043a\u043e\u043c\u0443-\u0442\u043e \u043e\u043d\u0430 \u043f\u043e\u043c\u043e\u0436\u0435\u0442 \u0432 \u0438\u0437\u0443\u0447\u0435\u043d\u0438\u0435 Swagger (OpenApi 3.0)<\/p>\n<h2>\u0412\u0432\u0435\u0434\u0435\u043d\u0438\u0435<\/h2>\n<p>\u042f \u043d\u0430 99% \u0443\u0432\u0435\u0440\u0435\u043d \u0443 \u043c\u043d\u043e\u0433\u0438\u0445 \u0438\u0437 \u0432\u0430\u0441 \u0431\u044b\u043b\u0438 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u044b \u0441 \u043f\u043e\u0438\u0441\u043a\u043e\u043c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0434\u043b\u044f \u043d\u0443\u0436\u043d\u043e\u0433\u043e \u0432\u0430\u043c \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u0430. \u041c\u043d\u043e\u0433\u0438\u0435 \u0435\u0441\u043b\u0438 \u0438 \u043d\u0430\u0445\u043e\u0434\u0438\u043b\u0438 \u0435\u0435 \u0431\u044b\u0441\u0442\u0440\u043e, \u043d\u043e \u0432 \u043a\u043e\u043d\u0435\u0447\u043d\u043e\u043c \u0438\u0442\u043e\u0433\u0435 \u043e\u043a\u0430\u0437\u044b\u0432\u0430\u043b\u043e\u0441\u044c \u0447\u0442\u043e \u043e\u043d\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043d\u0435 \u0442\u0430\u043a \u043a\u0430\u043a \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u043b\u0438\u0431\u043e \u0432\u043e\u043e\u0431\u0449\u0435 \u0435\u0433\u043e \u0443\u0436\u0435 \u043d\u0435\u0442.<br \/>\u0421\u0435\u0433\u043e\u0434\u043d\u044f \u044f \u0432\u0430\u043c \u0434\u043e\u043a\u0430\u0436\u0443, \u0447\u0442\u043e \u0435\u0441\u0442\u044c \u0441\u043f\u043e\u0441\u043e\u0431\u044b \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u043c \u0432\u0438\u0434\u0435 \u0438 \u0432 \u044d\u0442\u043e\u043c \u043c\u043d\u0435 \u0431\u0443\u0434\u0435\u0442 \u043f\u043e\u043c\u043e\u0433\u0430\u0442\u044c Open Source framework \u043e\u0442 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 SmartBear \u043f\u043e\u0434 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435\u043c Swagger, \u0430 \u0441 2016 \u0433\u043e\u0434\u0430 \u043e\u043d \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u043d\u043e\u0432\u043e\u0435 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 \u0438 \u0441\u0442\u0430\u043b \u043d\u0430\u0437\u044b\u0432\u0430\u0442\u044c\u0441\u044f OpenAPI Specification.<\/p>\n<p><strong>Swagger<\/strong> &#8212; \u044d\u0442\u043e \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a \u0434\u043b\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 RESTful API. \u0415\u0433\u043e \u043f\u0440\u0435\u043b\u0435\u0441\u0442\u044c \u0437\u0430\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u043e\u043d \u0434\u0430\u0435\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0438\u043d\u0442\u0435\u0440\u0430\u043a\u0442\u0438\u0432\u043d\u043e \u043f\u0440\u043e\u0441\u043c\u0430\u0442\u0440\u0438\u0432\u0430\u0442\u044c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e, \u043d\u043e \u0438 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0442\u044c \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u2013 \u0442\u0430\u043a \u043d\u0430\u0437\u044b\u0432\u0430\u0435\u043c\u044b\u0439 Swagger UI.<\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0435\u043f\u043e\u0441\u0440\u0435\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0430 \u0438\u043b\u0438 \u0441\u0435\u0440\u0432\u0435\u0440 \u043f\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 API Swagger, \u0434\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u043f\u043e\u043d\u0430\u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f Swagger Codegen.<\/p>\n<h2>\u041e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u043f\u043e\u0434\u0445\u043e\u0434\u044b<\/h2>\n<p>Swagger \u0438\u043c\u0435\u0435\u0442 \u0434\u0432\u0430 \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u043a \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438:<\/p>\n<ul>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u043d\u0430 \u043e\u0441\u043d\u043e\u0432\u0430\u043d\u0438\u0438 \u0432\u0430\u0448\u0435\u0433\u043e \u043a\u043e\u0434\u0430. <\/p>\n<ul>\n<li>\n<p>\u0414\u0430\u043d\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a &#171;\u043e\u0447\u0435\u043d\u044c \u043f\u0440\u043e\u0441\u0442\u043e&#187;. \u041d\u0430\u043c \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442, \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0438 \u0443\u0436\u0435 \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0438\u043c\u0435\u0442\u044c \u043d\u0443\u0436\u043d\u0443\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e, \u0445\u043e\u0442\u044c \u0438 \u043d\u0435 \u043d\u0430\u0441\u0442\u043e\u043b\u044c\u043a\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0439 \u043a\u0430\u043a\u043e\u044e \u043c\u044b \u0445\u043e\u0442\u0435\u043b\u0438.<\/p>\n<\/li>\n<li>\n<p>\u041a\u043e\u0434 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c\u0441\u044f \u043d\u0435 \u043e\u0447\u0435\u043d\u044c \u0447\u0438\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u044b\u043c \u043e\u0442 \u043e\u0431\u0438\u043b\u0438\u044f \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0439 \u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u0432 \u043d\u0438\u0445.<\/p>\n<\/li>\n<li>\n<p>\u0412\u0441\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0431\u0443\u0434\u0435\u0442 \u0432\u043f\u0438\u0441\u0430\u043d\u0430 \u0432 \u043d\u0430\u0448\u0435\u043c \u043a\u043e\u0434\u0435 (\u0432\u0441\u0435 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440\u044b \u0438 \u043c\u043e\u0434\u0435\u043b\u0438 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u0432 \u043d\u0435\u043a\u0438\u0439 Java Swagger Code) <\/p>\n<\/li>\n<li>\n<p>\u041f\u043e\u0434\u0445\u043e\u0434 \u043d\u0435 \u0441\u043e\u0432\u0435\u0442\u0443\u044e\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c, \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438, \u043d\u043e \u0435\u0433\u043e \u043e\u0447\u0435\u043d\u044c \u043f\u0440\u043e\u0441\u0442\u043e \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043e\u0442 \u043a\u043e\u0434\u0430.<\/p>\n<ul>\n<li>\n<p>\u0414\u0430\u043d\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0437\u043d\u0430\u0442\u044c \u0441\u0438\u043d\u0442\u0430\u043a\u0441\u0438\u0441 Swagger Specification. <\/p>\n<\/li>\n<li>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0438\u0448\u0435\u0442\u0441\u044f \u043b\u0438\u0431\u043e \u0432 JAML\/JSON \u0444\u0430\u0439\u043b\u0435, \u043b\u0438\u0431\u043e \u0432 \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u0435 Swagger Editor.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>Swagger Tools<\/h2>\n<p>Swagger \u0438\u043b\u0438 OpenAPI framework \u0441\u043e\u0441\u0442\u043e\u0438\u0442 \u0438\u0437 4 \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0445 \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u043e\u0432:<\/p>\n<ol>\n<li>\n<p><strong> <\/strong><a href=\"https:\/\/github.com\/swagger-api\/swagger-core\" rel=\"noopener noreferrer nofollow\"><strong>Swagger Core<\/strong><\/a> &#8212; \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u043d\u0430 \u043e\u0441\u043d\u043e\u0432\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0433\u043e \u043a\u043e\u0434\u0430 \u043e\u0441\u043d\u043e\u0432\u044b\u0432\u0430\u044f\u0441\u044c \u043d\u0430 Java Annotation.<\/p>\n<\/li>\n<li>\n<p><a href=\"https:\/\/github.com\/swagger-api\/swagger-codegen\" rel=\"noopener noreferrer nofollow\"><strong>Swagger Codegen<\/strong><\/a> &#8212; \u043f\u043e\u0437\u0432\u043e\u043b\u0438\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 \u0434\u043b\u044f \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438.<\/p>\n<\/li>\n<li>\n<p><a href=\"https:\/\/github.com\/swagger-api\/swagger-ui\" rel=\"noopener noreferrer nofollow\"><strong>Swagger UI<\/strong><\/a> &#8212; \u043a\u0440\u0430\u0441\u0438\u0432\u044b\u0439 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e. \u0414\u0430\u0435\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043a\u0430\u043a\u0438\u0435 \u0442\u0438\u043f\u044b \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0435\u0441\u0442\u044c, \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043c\u043e\u0434\u0435\u043b\u0435\u0439 \u0438 \u0438\u0445 \u0442\u0438\u043f\u043e\u0432 \u0434\u0430\u043d\u043d\u044b\u0445.<\/p>\n<\/li>\n<li>\n<p><a href=\"https:\/\/github.com\/swagger-api\/swagger-editor\" rel=\"noopener noreferrer nofollow\"><strong>Swagger Editor<\/strong><\/a> &#8212; \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043f\u0438\u0441\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 YAML \u0438\u043b\u0438 JSON \u0444\u043e\u0440\u043c\u0430\u0442\u0430.<\/p>\n<\/li>\n<\/ol>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u0434\u0430\u0432\u0430\u0439\u0442\u0435 \u043f\u043e\u0433\u043e\u0432\u043e\u0440\u0438\u043c \u043e \u043a\u0430\u0436\u0434\u043e\u043c \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u0435 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e.<\/p>\n<h2>Swagger Core<\/h2>\n<p><strong>Swagger Code <\/strong>&#8212; \u044d\u0442\u043e Java-\u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI<\/p>\n<p>\u0414\u043b\u044f \u0442\u043e\u0433\u043e \u0447\u0442\u043e \u0431\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c Swagger Core \u0432\u043e \u0432\u0441\u0435 \u043e\u0440\u0443\u0434\u0438\u0435, \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f:<\/p>\n<ul>\n<li>\n<p>Java 8 \u0438\u043b\u0438 \u0431\u043e\u043b\u044c\u0448\u0435<\/p>\n<\/li>\n<li>\n<p>Apache Maven 3.0.3 \u0438\u043b\u0438 \u0431\u043e\u043b\u044c\u0448\u0435<\/p>\n<\/li>\n<li>\n<p>Jackson 2.4.5 \u0438\u043b\u0438 \u0431\u043e\u043b\u044c\u0448\u0435<\/p>\n<\/li>\n<\/ul>\n<p>\u0427\u0442\u043e \u0431\u044b \u0432\u043d\u0435\u0434\u0440\u0438\u0442\u044c \u0435\u0433\u043e \u0432 \u043f\u0440\u043e\u0435\u043a\u0442, \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0434\u0432\u0435 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438:<\/p>\n<pre><code class=\"java\">&lt;dependency&gt;     &lt;groupId&gt;io.swagger.core.v3&lt;\/groupId&gt;     &lt;artifactId&gt;swagger-annotations&lt;\/artifactId&gt;     &lt;version&gt;2.1.6&lt;\/version&gt; &lt;\/dependency&gt; &lt;dependency&gt;     &lt;groupId&gt;org.springdoc&lt;\/groupId&gt;     &lt;artifactId&gt;springdoc-openapi-ui&lt;\/artifactId&gt;     &lt;version&gt;1.5.2&lt;\/version&gt; &lt;\/dependency&gt;<\/code><\/pre>\n<p>\u0422\u0430\u043a\u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c maven \u043f\u043b\u0430\u0433\u0438\u043d, \u0447\u0442\u043e \u0431\u044b \u043d\u0430\u0448\u0430 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0440\u0438 \u0441\u0431\u043e\u0440\u043a\u0435 \u043f\u0440\u043e\u0435\u043a\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043b\u0441\u044c \u0432 YAML<\/p>\n<pre><code class=\"java\">&lt;plugin&gt;  &lt;groupId&gt;org.springdoc&lt;\/groupId&gt;  &lt;artifactId&gt;springdoc-openapi-maven-plugin&lt;\/artifactId&gt;  &lt;version&gt;0.3&lt;\/version&gt;  &lt;executions&gt;    &lt;execution&gt;    &lt;phase&gt;integration-test&lt;\/phase&gt;    &lt;goals&gt;      &lt;goal&gt;generate&lt;\/goal&gt;    &lt;\/goals&gt;    &lt;\/execution&gt;  &lt;\/executions&gt;  &lt;configuration&gt;    &lt;apiDocsUrl&gt;http:\/\/localhost:8080\/v3\/api-docs&lt;\/apiDocsUrl&gt;    &lt;outputFileName&gt;openapi.yaml&lt;\/outputFileName&gt;    &lt;outputDir&gt;${project.build.directory}&lt;\/outputDir&gt;  &lt;\/configuration&gt; &lt;\/plugin&gt;<\/code><\/pre>\n<p>\u0414\u0430\u043b\u044c\u0448\u0435 \u043d\u0430\u043c \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043a\u043e\u043d\u0444\u0438\u0433 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442. <\/p>\n<p>\u0414\u043b\u044f \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 Swagger \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0434\u0432\u0430 \u0431\u0438\u043d\u0430. \u0413\u0434\u0435 \u043d\u0430\u043c \u043d\u0443\u0436\u043d\u043e \u0431\u0443\u0434\u0435\u0442 \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f, \u0432\u0435\u0440\u0441\u0438\u044e \u043d\u0430\u0448\u0435\u0433\u043e API, \u0442\u0430\u043a \u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043a\u043e\u043d\u0442\u0430\u043a\u0442 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u0437\u0430 \u0434\u0430\u043d\u043d\u044b\u0435 API<\/p>\n<pre><code class=\"java\">    @Bean     public GroupedOpenApi publicUserApi() {         return GroupedOpenApi.builder()                              .group(\"Users\")                              .pathsToMatch(\"\/users\/**\")                              .build();     }      @Bean     public OpenAPI customOpenApi(@Value(\"${application-description}\")String appDescription,                                  @Value(\"${application-version}\")String appVersion) {         return new OpenAPI().info(new Info().title(\"Application API\")                                             .version(appVersion)                                             .description(appDescription)                                             .license(new License().name(\"Apache 2.0\")                                                                   .url(\"http:\/\/springdoc.org\"))                                             .contact(new Contact().name(\"username\")                                                                   .email(\"test@gmail.com\")))                             .servers(List.of(new Server().url(\"http:\/\/localhost:8080\")                                                          .description(\"Dev service\"),                                              new Server().url(\"http:\/\/localhost:8082\")                                                          .description(\"Beta service\")));     }<\/code><\/pre>\n<p>\u041f\u043e\u0441\u043b\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u043d\u0443\u0436\u043d\u044b\u0445 \u043d\u0430\u043c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439, \u0443 \u043d\u0430\u0441 \u043f\u043e\u044f\u0432\u044f\u0442\u0441\u044f \u043d\u043e\u0432\u044b\u0435 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044f \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0430\u0448 \u043a\u043e\u0434.<\/p>\n<p>\u0412\u043e\u0442 \u043d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0438\u0437 \u043d\u0438\u0445:<\/p>\n<ul>\n<li>\n<p><strong> @Operation<\/strong> &#8212; \u041e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044e \u0438\u043b\u0438 \u043e\u0431\u044b\u0447\u043d\u043e \u043c\u0435\u0442\u043e\u0434 HTTP \u0434\u043b\u044f \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u043d\u043e\u0433\u043e \u043f\u0443\u0442\u0438.<\/p>\n<\/li>\n<li>\n<p><strong>@Parameter <\/strong>&#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043e\u0434\u0438\u043d \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u0432 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 OpenAPI.<\/p>\n<\/li>\n<li>\n<p><strong>@RequestBody<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0442\u0435\u043b\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u0432 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438<\/p>\n<\/li>\n<li>\n<p><strong>@ApiResponse<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043e\u0442\u0432\u0435\u0442 \u0432 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438<\/p>\n<\/li>\n<li>\n<p><strong>@Tag<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0442\u0435\u0433\u0438 \u0434\u043b\u044f \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 \u0438\u043b\u0438 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f OpenAPI.<\/p>\n<\/li>\n<li>\n<p><strong>@Server<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0441\u0435\u0440\u0432\u0435\u0440\u044b \u0434\u043b\u044f \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 \u0438\u043b\u0438 \u0434\u043b\u044f \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f OpenAPI.<\/p>\n<\/li>\n<li>\n<p><strong>@Callback<\/strong> &#8212; \u041e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u043d\u0430\u0431\u043e\u0440 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432<\/p>\n<\/li>\n<li>\n<p><strong>@Link<\/strong> &#8212; \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u0443\u044e \u0441\u0441\u044b\u043b\u043a\u0443 \u0432\u0440\u0435\u043c\u0435\u043d\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0434\u043b\u044f \u043e\u0442\u0432\u0435\u0442\u0430.<\/p>\n<\/li>\n<li>\n<p><strong>@Schema<\/strong> &#8212; \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0442\u044c \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u0438 \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435.<\/p>\n<\/li>\n<li>\n<p><strong>@ArraySchema<\/strong> &#8212; \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0442\u044c \u0432\u0445\u043e\u0434\u043d\u044b\u0435 \u0438 \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0435 \u0434\u0430\u043d\u043d\u044b\u0435 \u0434\u043b\u044f \u0442\u0438\u043f\u043e\u0432 \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u0432.<\/p>\n<\/li>\n<li>\n<p><strong>@Content <\/strong>&#8212; \u041f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0441\u0445\u0435\u043c\u0443 \u0438 \u043f\u0440\u0438\u043c\u0435\u0440\u044b \u0434\u043b\u044f \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u043d\u043e\u0433\u043e \u0442\u0438\u043f\u0430 \u043c\u0443\u043b\u044c\u0442\u0438\u043c\u0435\u0434\u0438\u0430.<\/p>\n<\/li>\n<li>\n<p><strong>@Hidden<\/strong> &#8212; \u0421\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0440\u0435\u0441\u0443\u0440\u0441, \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044e \u0438\u043b\u0438 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e<\/p>\n<\/li>\n<\/ul>\n<p>\u041f\u0440\u0438\u043c\u0435\u0440\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f:<\/p>\n<pre><code class=\"java\">@Tag(name = \"User\", description = \"The User API\") @RestController public class UserController {}<\/code><\/pre>\n<pre><code class=\"java\">    @Operation(summary = \"Gets all users\", tags = \"user\")     @ApiResponses(value = {             @ApiResponse(                     responseCode = \"200\",                     description = \"Found the users\",                     content = {                             @Content(                                     mediaType = \"application\/json\",                                     array = @ArraySchema(schema = @Schema(implementation = UserApi.class)))                     })     })     @GetMapping(\"\/users\")     public List&lt;UserApi&gt; getUsers()<\/code><\/pre>\n<h2>Swagger Codegen <\/h2>\n<p><strong>Swagger Codegen <\/strong>&#8212; \u044d\u0442\u043e \u043f\u0440\u043e\u0435\u043a\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0441\u043e\u0437\u0434\u0430\u0432\u0430\u0442\u044c \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 API (\u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0435 SDK), \u0437\u0430\u0433\u043b\u0443\u0448\u043a\u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0441 \u0443\u0447\u0435\u0442\u043e\u043c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI.<\/p>\n<p>\u0412 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0435 \u0432\u0440\u0435\u043c\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u044f\u0437\u044b\u043a\u0438 \/ \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u0438:<\/p>\n<ul>\n<li>\n<p>API clients:<\/p>\n<ul>\n<li>\n<p>Java (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured)<\/p>\n<\/li>\n<li>\n<p>Kotlin<\/p>\n<\/li>\n<li>\n<p>Scala (akka, http4s, swagger-async-httpclient)<\/p>\n<\/li>\n<li>\n<p>Groovy<\/p>\n<\/li>\n<li>\n<p>Node.js (ES5, ES6, AngularJS with Google Closure Compiler annotations)<\/p>\n<\/li>\n<li>\n<p>Haskell (http-client, Servant)<\/p>\n<\/li>\n<li>\n<p>C# (.net 2.0, 3.5 or later)<\/p>\n<\/li>\n<li>\n<p>C++ (cpprest, Qt5, Tizen)<\/p>\n<\/li>\n<li>\n<p>Bash<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Server stub:<\/p>\n<ul>\n<li>\n<p>Java (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, RestEasy, Play Framework, <a href=\"https:\/\/github.com\/ProKarma-Inc\/pkmst-getting-started-examples\" rel=\"noopener noreferrer nofollow\">PKMST<\/a>)<\/p>\n<\/li>\n<li>\n<p>Kotlin<\/p>\n<\/li>\n<li>\n<p>C# (ASP.NET Core, NancyFx)<\/p>\n<\/li>\n<li>\n<p>C++ (Pistache, Restbed)<\/p>\n<\/li>\n<li>\n<p>Haskell (Servant)<\/p>\n<\/li>\n<li>\n<p>PHP (Lumen, Slim, Silex, <a href=\"https:\/\/symfony.com\/\" rel=\"noopener noreferrer nofollow\">Symfony<\/a>, <a href=\"https:\/\/github.com\/zendframework\/zend-expressive\" rel=\"noopener noreferrer nofollow\">Zend Expressive<\/a>)<\/p>\n<\/li>\n<li>\n<p>Python (Flask)<\/p>\n<\/li>\n<li>\n<p>NodeJS<\/p>\n<\/li>\n<li>\n<p>Ruby (Sinatra, Rails5)<\/p>\n<\/li>\n<li>\n<p>Rust (rust-server)<\/p>\n<\/li>\n<li>\n<p>Scala (<a href=\"https:\/\/github.com\/finagle\/finch\" rel=\"noopener noreferrer nofollow\">Finch<\/a>, <a href=\"https:\/\/github.com\/lagom\/lagom\" rel=\"noopener noreferrer nofollow\">Lagom<\/a>, Scalatra)<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>API documentation generators:<\/p>\n<ul>\n<li>\n<p>HTML<\/p>\n<\/li>\n<li>\n<p>Confluence Wiki<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Other:<\/p>\n<ul>\n<li>\n<p>JMeter<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>\u0427\u0442\u043e \u0431\u044b \u0432\u043d\u0435\u0434\u0440\u0438\u0442\u044c \u0435\u0433\u043e \u0432 \u043f\u0440\u043e\u0435\u043a\u0442, \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044c, \u0435\u0441\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435 Swagger:<\/p>\n<pre><code class=\"java\">&lt;dependency&gt;     &lt;groupId&gt;io.swagger&lt;\/groupId&gt;     &lt;artifactId&gt;swagger-codegen-maven-plugin&lt;\/artifactId&gt;     &lt;version&gt;2.4.18&lt;\/version&gt; &lt;\/dependency&gt;<\/code><\/pre>\n<p>\u0438 \u0435\u0441\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435 OpenApi 3.0, \u0442\u043e:<\/p>\n<pre><code class=\"java\">&lt;dependency&gt;     &lt;groupId&gt;io.swagger.codegen.v3&lt;\/groupId&gt;     &lt;artifactId&gt;swagger-codegen-maven-plugin&lt;\/artifactId&gt;     &lt;version&gt;3.0.24&lt;\/version&gt; &lt;\/dependency&gt;<\/code><\/pre>\n<p>\u041c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c maven \u043f\u043b\u0430\u0433\u0438\u043d, \u0438 \u0443\u0436\u0435 \u043d\u0430 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0435 \u0441\u0431\u043e\u0440\u043a\u0438 \u043c\u044b \u043c\u043e\u0436\u0435\u043c \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043d\u0443\u0436\u043d\u044b\u0439 \u0434\u043b\u044f \u043d\u0430\u0441 \u043a\u043b\u0438\u0435\u043d\u0442 \u043b\u0438\u0431\u043e \u043c\u043e\u043a \u0441\u0435\u0440\u0432\u0438\u0441\u0430.<\/p>\n<pre><code class=\"java\">      &lt;plugin&gt;         &lt;groupId&gt;org.openapitools&lt;\/groupId&gt;         &lt;artifactId&gt;openapi-generator-maven-plugin&lt;\/artifactId&gt;         &lt;version&gt;3.3.4&lt;\/version&gt;         &lt;executions&gt;           &lt;execution&gt;             &lt;phase&gt;compile&lt;\/phase&gt;             &lt;goals&gt;               &lt;goal&gt;generate&lt;\/goal&gt;             &lt;\/goals&gt;             &lt;configuration&gt;               &lt;generatorName&gt;spring&lt;\/generatorName&gt;               &lt;inputSpec&gt;${project.basedir}\/src\/main\/resources\/api.yaml&lt;\/inputSpec&gt;               &lt;output&gt;${project.build.directory}\/generated-sources&lt;\/output&gt;               &lt;apiPackage&gt;com.api&lt;\/apiPackage&gt;               &lt;modelPackage&gt;com.model&lt;\/modelPackage&gt;               &lt;supportingFilesToGenerate&gt;                 ApiUtil.java               &lt;\/supportingFilesToGenerate&gt;               &lt;configOptions&gt;                 &lt;groupId&gt;${project.groupId}&lt;\/groupId&gt;                 &lt;artifactId&gt;${project.artifactId}&lt;\/artifactId&gt;                 &lt;artifactVersion&gt;${project.version}&lt;\/artifactVersion&gt;                 &lt;delegatePattern&gt;true&lt;\/delegatePattern&gt;                 &lt;sourceFolder&gt;swagger&lt;\/sourceFolder&gt;                 &lt;library&gt;spring-mvc&lt;\/library&gt;                 &lt;interfaceOnly&gt;true&lt;\/interfaceOnly&gt;                 &lt;useBeanValidation&gt;true&lt;\/useBeanValidation&gt;                 &lt;dateLibrary&gt;java8&lt;\/dateLibrary&gt;                 &lt;java8&gt;true&lt;\/java8&gt;               &lt;\/configOptions&gt;               &lt;ignoreFileOverride&gt;${project.basedir}\/.openapi-generator-ignore&lt;\/ignoreFileOverride&gt;             &lt;\/configuration&gt; <\/code><\/pre>\n<\/p>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-317749","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/317749","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=317749"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/317749\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=317749"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=317749"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=317749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}