{"id":498931,"date":"2026-10-16T13:02:46","date_gmt":"2026-10-16T10:02:46","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=498931"},"modified":"2026-10-16T13:02:46","modified_gmt":"2026-10-16T10:02:46","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=498931","title":{"rendered":"Genoas\u00a0\u2014 \u0435\u0449\u0451 \u043e\u0434\u0438\u043d \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 OpenAPI 3.1\u00a0\u0434\u043b\u044f\u00a0Go"},"content":{"rendered":"<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p>\u0412\u0441\u0435\u043c \u043f\u0440\u0438\u0432\u0435\u0442!<\/p>\n<p>\u041c\u0435\u043d\u044f \u0437\u043e\u0432\u0443\u0442 \u0415\u0433\u043e\u0440, \u0438 \u044f \u0443\u0436\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u0435\u0442 \u043f\u0438\u0448\u0443 \u043d\u0430\u00a0Go.<\/p>\n<p>\u0421\u0435\u0433\u043e\u0434\u043d\u044f \u044f \u0445\u043e\u0442\u0435\u043b\u00a0\u0431\u044b \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0441\u0432\u043e\u0439 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u043f\u043e\u00a0\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u0441\u0432\u0430\u0433\u0435\u0440\u0430 \u0434\u043b\u044f\u00a0Go\u2011\u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432.<\/p>\n<h2>\u0421\u00a0\u0447\u0435\u0433\u043e \u0432\u0441\u0451 \u043d\u0430\u0447\u0430\u043b\u043e\u0441\u044c<\/h2>\n<p>\u041a\u043e\u0433\u0434\u0430 \u044f \u0440\u0430\u0431\u043e\u0442\u0430\u043b \u0432\u00a0\u0431\u0430\u043d\u043a\u0435, \u0443\u00a0\u043d\u0430\u0441 \u0431\u044b\u043b\u0438 \u0436\u0451\u0441\u0442\u043a\u0438\u0435 \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f: API \u0431\u044d\u043a\u0435\u043d\u0434\u0430 \u0434\u043e\u043b\u0436\u043d\u043e \u0431\u044b\u0442\u044c \u0434\u043e\u0441\u043a\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043e. \u041f\u0430\u0442\u0442\u0435\u0440\u043d\u044b \u0434\u043b\u044f\u00a0\u0441\u0442\u0440\u043e\u043a, \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f\/\u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0434\u043b\u0438\u043d\u0430 \u0438 \u0442\u0430\u043a \u0434\u0430\u043b\u0435\u0435. \u041d\u043e\u00a0\u0433\u043b\u0430\u0432\u043d\u043e\u0435\u00a0\u2014 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u0434\u043e\u043b\u0436\u043d\u0430 \u0431\u044b\u043b\u0430 \u0431\u044b\u0442\u044c \u0432\u0435\u0440\u0441\u0438\u0438 \u043d\u0435\u00a0\u043d\u0438\u0436\u0435 3.0.<\/p>\n<p>\u041a\u00a0\u0441\u043e\u0436\u0430\u043b\u0435\u043d\u0438\u044e, \u043f\u043e\u0434\u0445\u043e\u0434\u044f\u0449\u0438\u0445 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a \u043d\u0430\u00a0\u0442\u043e\u0442 \u043c\u043e\u043c\u0435\u043d\u0442 \u0431\u044b\u043b\u043e \u043d\u0435\u00a0\u0442\u043e \u0447\u0442\u043e\u0431\u044b \u043c\u043d\u043e\u0433\u043e. \u042f \u0443\u0436\u0435 \u043d\u0435\u00a0\u0433\u043e\u0432\u043e\u0440\u044e \u043e\u00a0\u0442\u043e\u043c, \u043f\u043e\u0434\u0445\u043e\u0434\u0438\u043b\u0438\u00a0\u043b\u0438 \u043e\u043d\u0438 \u043d\u0430\u043c \u0432\u043e\u043e\u0431\u0449\u0435. \u041a\u043e\u043d\u0435\u0447\u043d\u043e, \u0431\u044b\u043b swaggo\/swag, \u043d\u043e\u00a0\u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 3.0\u00a0\u0442\u043e\u0433\u0434\u0430 \u0431\u044b\u043b\u0430 \u0442\u043e\u043b\u044c\u043a\u043e \u0432\u00a0\u0437\u0430\u0447\u0430\u0442\u043a\u0435.<\/p>\n<p>\u041c\u044b \u0432\u044b\u0431\u0440\u0430\u043b\u0438 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 <a rel=\"noopener nofollow\">go\u2011swagger3<\/a>, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043d\u0430\u00a0\u0442\u043e\u0442 \u043c\u043e\u043c\u0435\u043d\u0442 \u0443\u0436\u0435 \u0434\u043e\u043b\u0433\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u043d\u0435\u00a0\u043e\u0431\u043d\u043e\u0432\u043b\u044f\u043b\u0430\u0441\u044c, \u043d\u043e\u00a0\u0432\u00a0\u0446\u0435\u043b\u043e\u043c \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u043b\u0430 \u0431\u044b\u0441\u0442\u0440\u043e \u0437\u0430\u043b\u0430\u0442\u0430\u0442\u044c \u0434\u044b\u0440\u0443 \u0441\u00a0\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 API. \u0418 \u0432\u0441\u0451\u00a0\u0431\u044b \u0442\u0430\u043a \u0438 \u043e\u0441\u0442\u0430\u0432\u0430\u043b\u043e\u0441\u044c, \u043d\u043e\u00a0\u0432\u00a0\u043a\u0430\u043a\u043e\u0439\u2011\u0442\u043e \u043c\u043e\u043c\u0435\u043d\u0442 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0440\u0443\u0447\u0435\u043a \u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0439 \u043a\u00a0\u043d\u0438\u043c \u043d\u0430\u0447\u0430\u043b\u043e \u043b\u043e\u043c\u0430\u0442\u044c \u0435\u0435: \u043f\u0440\u043e\u043f\u0430\u0434\u0430\u043b\u0438 \u0446\u0435\u043b\u044b\u0435 \u043a\u0443\u0441\u043a\u0438 \u0441\u043f\u0435\u043a\u0438, \u0442\u043e\u0447\u0435\u0447\u043d\u043e \u0442\u0435\u0440\u044f\u043b\u0438\u0441\u044c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u043f\u043e\u043b\u0435\u0439 \u0438 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f. \u0412\u0441\u0451 \u0447\u0430\u0449\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u043b\u043e\u0441\u044c \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c, \u0447\u0442\u043e\u00a0\u0438\u043c\u0435\u043d\u043d\u043e \u0438\u0437\u043c\u0435\u043d\u0438\u043b\u043e\u0441\u044c \u0432\u00a0\u0441\u0432\u0430\u0433\u0435\u0440\u0435 \u043f\u043e\u0441\u043b\u0435 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438,\u00a0\u2014 \u0438\u043b\u0438\u00a0\u0432\u043e\u0432\u0441\u0435 \u043f\u0440\u0430\u0432\u0438\u0442\u044c \u0435\u0433\u043e \u0440\u0443\u043a\u0430\u043c\u0438. \u041f\u043b\u044e\u0441 \u043e\u043d\u0430 \u043d\u0435\u00a0\u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u043b\u0430 \u043d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u0435\u0449\u0438\u00a0\u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043e\u0442\u0432\u0435\u0442 \u0432\u00a0\u0432\u0438\u0434\u0435 \u0441\u0442\u0440\u043e\u043a\u0438.<\/p>\n<p>\u041a\u00a0\u0442\u043e\u043c\u0443\u00a0\u0436\u0435, \u0447\u0442\u043e\u00a0\u0432\u00a0swag, \u0447\u0442\u043e\u00a0\u0432\u00a0go\u2011swagger3, \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0438 \u043a\u00a0\u0440\u0443\u0447\u043a\u0430\u043c, \u043b\u0438\u0447\u043d\u043e \u043d\u0430\u00a0\u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434\u00a0\u2014 \u043f\u0435\u0440\u0435\u0433\u0440\u0443\u0436\u0435\u043d\u044b.<\/p>\n<p>\u0422\u043e\u0433\u0434\u0430 \u044f \u0440\u0435\u0448\u0438\u043b \u0432\u0437\u044f\u0442\u044c\u0441\u044f \u0437\u0430\u00a0\u0435\u0451 \u0430\u043a\u0442\u0443\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044e \u0438 \u0443\u043f\u0440\u043e\u0449\u0435\u043d\u0438\u0435, \u043d\u043e\u00a0\u0431\u044b\u0441\u0442\u0440\u043e \u043f\u043e\u043d\u044f\u043b, \u0447\u0442\u043e\u00a0\u0434\u0435\u043b\u043e \u044d\u0442\u043e \u0433\u0438\u0431\u043b\u043e\u0435. \u0422\u0430\u043a \u044f \u043d\u0430\u0447\u0430\u043b \u043f\u043e\u0442\u0438\u0445\u043e\u043d\u044c\u043a\u0443 \u043f\u0438\u043b\u0438\u0442\u044c \u0441\u0432\u043e\u044e \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044e.<\/p>\n<h2>\u0427\u0442\u043e\u00a0\u043f\u043e\u043b\u0443\u0447\u0438\u043b\u043e\u0441\u044c<\/h2>\n<p>\u0415\u0441\u043b\u0438 \u0432\u044b \u043f\u044b\u0442\u0430\u043b\u0438\u0441\u044c \u0440\u0430\u0437\u043e\u0431\u0440\u0430\u0442\u044c\u0441\u044f \u0432\u00a0\u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u0430\u0445 swag\u00a0\u2014 \u0434\u0443\u043c\u0430\u044e, \u0441\u043e\u0433\u043b\u0430\u0441\u0438\u0442\u0435\u0441\u044c \u043d\u0430\u00a0\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u044d\u0442\u043e \u0442\u0440\u0443\u0434\u043d\u043e \u0438 \u0434\u043e\u043b\u0433\u043e. <\/p>\n<p>\u0412\u00a0\u0441\u0432\u043e\u0451\u043c \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u044f \u043f\u043e\u0441\u0442\u0430\u0440\u0430\u043b\u0441\u044f \u0443\u043f\u0440\u043e\u0441\u0442\u0438\u0442\u044c \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0435\u0432, \u043e\u0442\u043a\u0430\u0437\u0430\u0442\u044c\u0441\u044f \u043e\u0442\u00a0\u0440\u0443\u0447\u043d\u043e\u0433\u043e \u043f\u0430\u0440\u0441\u0438\u043d\u0433\u0430 \u0442\u0438\u043f\u043e\u0432 \u0438 \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u043f\u0440\u0438\u00a0\u044d\u0442\u043e\u043c \u0432\u0441\u0451 \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u00a0\u043f\u043b\u0430\u043d\u0435 \u043a\u043e\u0434\u0430.<\/p>\n<p>\u0414\u043b\u044f\u00a0\u044d\u0442\u043e\u0433\u043e \u043f\u0440\u0438\u0448\u043b\u043e\u0441\u044c \u0440\u0430\u0437\u0431\u0438\u0442\u044c \u0432\u0441\u0451 \u043d\u0430\u00a0\u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0441\u0435\u0440\u044b \u0438 \u0432\u044b\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0438\u0437\u00a0\u043d\u0438\u0445 \u043a\u043e\u043d\u0432\u0435\u0439\u0435\u0440. \u0422\u0430\u043a\u0436\u0435 \u043c\u043d\u0435 \u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c, \u0447\u0442\u043e\u0431\u044b \u043f\u0440\u043e\u0435\u043a\u0442 \u043c\u043e\u0436\u043d\u043e \u0431\u044b\u043b\u043e \u0440\u0430\u0441\u0448\u0438\u0440\u044f\u0442\u044c \u0438\u043b\u0438\u00a0\u0437\u0430\u043c\u0435\u043d\u044f\u0442\u044c \u043a\u0430\u043a\u0438\u0435\u2011\u0442\u043e \u0435\u0433\u043e \u0447\u0430\u0441\u0442\u0438, \u0435\u0441\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044e \u0432\u0434\u0440\u0443\u0433 \u043d\u0435\u00a0\u043f\u043e\u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f, \u043a\u0430\u043a\u00a0\u043f\u0430\u0440\u0441\u0438\u0442\u0441\u044f, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0442\u0435\u043b\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u0438\u0437\u00a0\u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f.<\/p>\n<p>\u0412\u043e\u0442 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u0442\u043e\u0433\u043e, \u043a\u0430\u043a\u00a0\u0443\u0434\u0430\u043b\u043e\u0441\u044c \u0443\u043f\u0440\u043e\u0441\u0442\u0438\u0442\u044c \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0435\u0432, \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u0432 \u0447\u0438\u0442\u0430\u0435\u043c\u043e\u0441\u0442\u044c:<\/p>\n<p><em>P.\u202fS. \u0417\u0434\u0435\u0441\u044c \u0438 \u0434\u0430\u043b\u0435\u0435 \u044f \u0431\u0443\u0434\u0443 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0442\u044c \u0441\u043e swag \u043a\u0430\u043a\u00a0\u0441\u00a0\u044d\u0442\u0430\u043b\u043e\u043d\u043e\u043c.<\/em><\/p>\n<pre><code class=\"go\">\/\/ swag:\/\/ @Summary \u0421\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432\/\/ @Param   limit  query    int  false  \"\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439\"\/\/ @Success 200    {array}  models.Pet  \"\u0441\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432\"\/\/ @Produce json\/\/ @Router  \/pets [get]\/\/ genoas:\/\/ @Title    \u0421\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432\/\/ @Query    limit  int       example(20) description(\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439)\/\/ @Success  200    json      []models.Pet  description(\u0441\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432)\/\/ @Route    \/pets [get]<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><span class=\"sc-logo-wrapper\"><\/span><\/a><\/div><\/pre>\n<p>\u0415\u0449\u0435 \u043f\u0440\u0438\u043c\u0435\u0440: \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0438 \u043e\u0442\u0432\u0435\u0442\u0430. <\/p>\n<p>\u0412\u00a0swag \u043e\u043d\u0438 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u0442\u0430\u043a: <\/p>\n<pre><code class=\"go\">\/\/ @Header 200 {string} Token \"token\"<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><span class=\"sc-logo-wrapper icon-only\"><\/span><\/a><\/div><\/pre>\n<p>\u0412\u00a0genoas \u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:<\/p>\n<pre><code class=\"go\">\/\/ @Header.Response  200  X-Request-Id  string  example(3fa85f64)  description(\u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0437\u0430\u043f\u0440\u043e\u0441\u0430)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><span class=\"sc-logo-wrapper icon-only\"><\/span><\/a><\/div><\/pre>\n<p>\u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u043d\u044b\u0435 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0437\u0430\u043c\u0435\u043d\u0435\u043d\u044b \u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438. \u041b\u0438\u0447\u043d\u043e \u044f \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u043e \u043f\u0443\u0442\u0430\u043b\u0441\u044f \u0432\u00a0\u0442\u043e\u043c, \u0447\u0442\u043e\u00a0\u0437\u0430\u00a0\u0447\u0435\u043c \u0434\u043e\u043b\u0436\u043d\u043e \u0438\u0434\u0442\u0438, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0440\u0435\u0448\u0438\u043b, \u0447\u0442\u043e\u00a0\u0441\u0442\u0440\u043e\u043a\u0443 \u043f\u0440\u043e\u0449\u0435 \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0442\u044c, \u0437\u043d\u0430\u044f \u0438\u043c\u0435\u043d\u0430 \u0441\u0432\u043e\u0439\u0441\u0442\u0432, \u0447\u0435\u043c \u043f\u0430\u0440\u0441\u0438\u0442\u044c \u043f\u043e\u0437\u0438\u0446\u0438\u0438 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043a\u0430\u043c\u0438, \u043a\u0430\u043a\u00a0\u044d\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442 swag,\u00a0\u2014 \u043f\u0443\u0441\u0442\u044c \u044d\u0442\u043e \u0438 \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u043c\u043d\u043e\u0433\u043e\u0441\u043b\u043e\u0432\u043d\u0435\u0435.<\/p>\n<p>\u0421\u0430\u043c\u0438 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u043c\u043e\u0436\u043d\u043e \u043f\u0438\u0441\u0430\u0442\u044c \u0432\u00a0\u0434\u0432\u0443\u0445 \u0441\u0442\u0438\u043b\u044f\u0445\u00a0\u2014 \u043d\u0430\u00a0\u0432\u043a\u0443\u0441:<\/p>\n<pre><code class=\"go\">\/\/ parensStyle (\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e)\/\/ @Query  limit  int  minLength(1)  example(20)  description(\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439)\/\/ goStyle \u2014 \u043a\u0430\u043a \u0442\u0435\u0433\u0438 \u043f\u043e\u043b\u0435\u0439 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440 \u0432 Go\/\/ @Query  limit  int  minLength:\"1\"  example:\"20\"  description:\"\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439\"<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><span class=\"sc-logo-wrapper icon-only\"><\/span><\/a><\/div><\/pre>\n<p>\u0421\u0442\u0438\u043b\u044c \u0432\u044b\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0444\u043b\u0430\u0433\u043e\u043c <code>--comment-style<\/code>.<\/p>\n<p>\u041e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043f\u0440\u043e\u00a0\u0442\u043e, \u043a\u0430\u043a\u00a0\u044d\u0442\u043e \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u043e \u0432\u043d\u0443\u0442\u0440\u0438. <\/p>\n<p>\u0418 swag, \u0438 go\u2011swagger3\u00a0\u0440\u0430\u0437\u0431\u0438\u0440\u0430\u044e\u0442 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043d\u044b\u043c\u0438 \u0432\u044b\u0440\u0430\u0436\u0435\u043d\u0438\u044f\u043c\u0438. \u042f \u043f\u043e\u0448\u0435\u043b \u0434\u0440\u0443\u0433\u0438\u043c \u043f\u0443\u0442\u0451\u043c: \u0430\u0434\u0430\u043f\u0442\u0438\u0440\u043e\u0432\u0430\u043b <code>reflect.StructTag<\/code> \u0438\u0437\u00a0\u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u043e\u0439 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438, \u043d\u0430\u0443\u0447\u0438\u0432 \u0435\u0433\u043e \u0440\u0430\u0437\u0434\u0435\u043b\u044f\u0442\u044c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0442\u0430\u0431\u0443\u043b\u044f\u0446\u0438\u0435\u0439 \u0438 \u044d\u043a\u0440\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u0438\u043c\u0432\u043e\u043b\u044b \u0432\u00a0\u0441\u043a\u043e\u0431\u043e\u0447\u043d\u043e\u043c \u0441\u0442\u0438\u043b\u0435. \u0412\u043c\u0435\u0441\u0442\u043e \u0445\u0440\u0443\u043f\u043a\u0438\u0445 \u0440\u0435\u0433\u0435\u043a\u0441\u043e\u0432\u00a0\u2014 \u043f\u0440\u043e\u0441\u0442\u043e\u0439 \u0441\u043a\u0430\u043d\u0435\u0440 \u0432\u00a0\u0434\u0443\u0445\u0435 stdlib: \u043e\u043d \u043d\u0435\u00a0\u0441\u043b\u043e\u043c\u0430\u0435\u0442\u0441\u044f \u043e\u00a0\u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u0441\u00a0\u043f\u0440\u043e\u0431\u0435\u043b\u0430\u043c\u0438 \u0438\u043b\u0438\u00a0\u043a\u0430\u0432\u044b\u0447\u043a\u0430\u043c\u0438 \u0432\u043d\u0443\u0442\u0440\u0438. \u0427\u0435\u0441\u0442\u043d\u044b\u0445 \u0431\u0435\u043d\u0447\u043c\u0430\u0440\u043a\u043e\u0432 \u043d\u0435\u00a0\u0433\u043e\u043d\u044f\u043b, \u043d\u043e\u00a0\u043b\u0438\u043d\u0435\u0439\u043d\u044b\u0439 \u043f\u0440\u043e\u0445\u043e\u0434 \u043f\u043e\u00a0\u0441\u0442\u0440\u043e\u043a\u0435 \u0430\u043f\u0440\u0438\u043e\u0440\u0438 \u043d\u0435\u00a0\u0434\u043e\u0440\u043e\u0436\u0435 \u0440\u0435\u0433\u0435\u043a\u0441\u043e\u0432, \u0430\u00a0\u043f\u043e\u00a0\u043d\u0430\u0434\u0451\u0436\u043d\u043e\u0441\u0442\u0438 \u043d\u0430\u00a0\u0433\u0440\u0430\u043d\u0438\u0447\u043d\u044b\u0445 \u0441\u043b\u0443\u0447\u0430\u044f\u0445\u00a0\u2014 \u0437\u0430\u043c\u0435\u0442\u043d\u043e \u043f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u0435\u0435.<\/p>\n<p>\u041e\u0434\u0438\u043d \u0438\u0437\u00a0\u043f\u0443\u043d\u043a\u0442\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u0445\u043e\u0442\u0435\u043b \u0437\u0430\u043a\u0440\u044b\u0442\u044c,\u00a0\u2014 \u044d\u0442\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f. \u0427\u0435\u0441\u0442\u043d\u043e, \u044d\u0442\u043e \u043c\u043e\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0431\u043e\u043b\u044c: \u043a\u043e\u0433\u0434\u0430 \u0443\u00a0\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u043d\u0435\u0442 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u0434\u043e\u0434\u0443\u043c\u044b\u0432\u0430\u0442\u044c, \u043a\u0430\u043a\u00a0\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u0443 \u0438\u043b\u0438\u00a0\u0438\u043d\u0443\u044e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0443\u00a0genoas \u0441\u0442\u0430\u0440\u0430\u044e\u0441\u044c \u0432\u0435\u0441\u0442\u0438 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u0443\u044e <a href=\"https:\/\/gitlab.com\/torenter\/genoas\/-\/blob\/main\/doc\/home.md\" rel=\"noopener nofollow\">\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e<\/a> \u0441\u00a0\u043f\u0440\u0438\u043c\u0435\u0440\u0430\u043c\u0438 \u043d\u0430\u00a0\u043a\u0430\u0436\u0434\u044b\u0439 \u0442\u0435\u0433 \u0438 \u043a\u0430\u0436\u0434\u044b\u0439 \u0442\u0438\u043f.<\/p>\n<p>\u041d\u0435\u00a0\u0431\u0443\u0434\u0443 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u043f\u0443\u043d\u043a\u0442\u00a0\u2014 \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u044e \u043a\u0440\u0430\u0442\u043a\u043e\u0435 \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u0435 \u0441\u043e swag:<\/p>\n<div>\n<div class=\"table\">\n<table>\n<tbody>\n<tr>\n<td>\n<p align=\"left\">\n<\/td>\n<td>\n<p align=\"left\"><strong>genoas<\/strong> <\/p>\n<\/td>\n<td>\n<p align=\"left\"><strong>swag<\/strong> <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u0412\u0435\u0440\u0441\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 <\/p>\n<\/td>\n<td>\n<p align=\"left\">OpenAPI 3.1+\u00a0\u2014 \u043e\u0441\u043d\u043e\u0432\u043d\u0430\u044f \u0438 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u0430\u044f \u0446\u0435\u043b\u044c <\/p>\n<\/td>\n<td>\n<p align=\"left\">OpenAPI 2.0; 3.1\u00a0\u2014 \u044d\u043a\u0441\u043f\u0435\u0440\u0438\u043c\u0435\u043d\u0442\u0430\u043b\u044c\u043d\u044b\u0439 \u0444\u043b\u0430\u0433 <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u0414\u0436\u0435\u043d\u0435\u0440\u0438\u043a\u0438 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435 \u0438 \u043a\u0440\u043e\u0441\u0441\u2011\u043f\u0430\u043a\u0435\u0442\u043d\u044b\u0435; \u0442\u0438\u043f \u043f\u043e\u043b\u044f \u0432\u044b\u0447\u0438\u0441\u043b\u044f\u0435\u0442\u0441\u044f \u0432\u00a0\u0441\u043a\u043e\u0443\u043f\u0435 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u043c\u043e\u0434\u0435\u043b\u0438 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435; \u043d\u0430\u00a0\u043a\u0440\u043e\u0441\u0441\u2011\u043f\u0430\u043a\u0435\u0442\u043d\u044b\u0445 \u043a\u0435\u0439\u0441\u0430\u0445 \u0435\u0441\u0442\u044c \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u0435 issue <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u041f\u043e\u0434\u043c\u0435\u043d\u0430 \u0442\u0438\u043f\u0430 \u043f\u043e\u043b\u044f <\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>swaggerType<\/code>, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u043a\u043e\u043c\u043f\u043e\u0437\u0438\u0446\u0438\u044e:\u00a0<code>oneOf<\/code>\u00a0\/\u00a0<code>anyOf<\/code>\u00a0\/\u00a0<code>allOf<\/code>\u00a0\u0447\u0435\u0440\u0435\u0437 \u043f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u0435\u043d\u0438\u0435 \u0442\u0438\u043f\u043e\u0432 <\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>swaggertype<\/code>\u00a0\u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0441\u0442\u0430\u044f \u043f\u043e\u0434\u043c\u0435\u043d\u0430 <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">multipart\/form\u2011data <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043f\u043e 3.1: \u043f\u0441\u0435\u0432\u0434\u043e\u0442\u0438\u043f\u00a0<code>file<\/code>,\u00a0<code>contentMediaType<\/code>,\u00a0<code>contentEncoding<\/code> <\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>formData<\/code>\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0432\u00a0\u0441\u0442\u0438\u043b\u0435 2.0 <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u041f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c \u043d\u0430\u00a0\u043f\u043e\u043b\u044f\u0445 \u0438 \u0442\u0435\u043b\u0430\u0445 <\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>oneOf<\/code>\u00a0\/\u00a0<code>anyOf<\/code>\u00a0\/\u00a0<code>allOf<\/code>,\u00a0<code>nullable<\/code>\u00a0\u0432\u00a0\u0441\u0438\u043d\u0442\u0430\u043a\u0441\u0438\u0441\u0435 3.1 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u043d\u043e <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u041f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u043e\u0441\u0442\u044c \u0432\u044b\u0432\u043e\u0434\u0430 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0442\u0430\u0431\u043b\u0438\u0447\u043d\u044b\u0435 unit\u2011\u0442\u0435\u0441\u0442\u044b \u0432\u0441\u0435\u0445 \u043f\u0430\u0440\u0441\u0435\u0440\u043e\u0432 + \u0434\u0435\u0442\u0435\u0440\u043c\u0438\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 e2e\u2011\u0433\u0435\u0439\u0442 (<code>make golden-check<\/code>) <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u2014 <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u041f\u043e\u0442\u0440\u0435\u0431\u043b\u0435\u043d\u0438\u0435 \u043f\u0430\u043c\u044f\u0442\u0438 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043b\u0451\u0433\u043a\u0430\u044f \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0430 \u043f\u0430\u043a\u0435\u0442\u043e\u0432 (~300\u00a0\u041c\u0411 \u043d\u0430\u00a0\u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445) <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0435 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u044b \u0441\u00a0OOM \u043d\u0430\u00a0\u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445 <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u0417\u0440\u0435\u043b\u043e\u0441\u0442\u044c \u0438 \u044d\u043a\u043e\u0441\u0438\u0441\u0442\u0435\u043c\u0430 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043c\u043e\u043b\u043e\u0434\u043e\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0437\u0440\u0435\u043b\u044b\u0439: \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0438 \u0441\u00a0gin\/echo\/fiber, \u043e\u0433\u0440\u043e\u043c\u043d\u043e\u0435 \u0441\u043e\u043e\u0431\u0449\u0435\u0441\u0442\u0432\u043e <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u041f\u043e\u043b\u043d\u043e\u0442\u0430 \u043f\u043e\u043a\u0440\u044b\u0442\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0440\u0430\u0441\u0442\u0451\u0442 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0448\u0438\u0440\u0435, \u043d\u043e\u00a0\u0432\u00a0\u0440\u0430\u043c\u043a\u0430\u0445 2.0 <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">x\u2011\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f (<code>x-...<\/code>) <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043f\u043e\u043a\u0430 \u043d\u0435\u0442 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0435\u0441\u0442\u044c <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u0422\u0438\u043f\u044b \u0432\u00a0\u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 Go\u2011\u0442\u0438\u043f\u044b \u043a\u0430\u043a\u00a0\u0435\u0441\u0442\u044c:\u00a0<code>[]models.Pet<\/code>,\u00a0<code>map[string]int<\/code>,\u00a0<code>GenericModel[A,B]<\/code> <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0441\u0432\u043e\u044f \u043d\u043e\u0442\u0430\u0446\u0438\u044f:\u00a0<code>{object}<\/code>,\u00a0<code>{array}<\/code>\u00a0\u2014 \u0442\u0438\u043f \u0442\u0440\u0430\u043d\u0441\u043b\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432\u0440\u0443\u0447\u043d\u0443\u044e <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u0421\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0442\u0435\u0433\u043e\u0432 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u0435, \u0432\u00a0\u043b\u044e\u0431\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435:\u00a0<code>description(...) example(20)<\/code> <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u043d\u044b\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b:\u00a0<code>@Param id path int true \"Pet ID\"<\/code> <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u0421\u0442\u0438\u043b\u0438 \u0437\u0430\u043f\u0438\u0441\u0438 \u0441\u0432\u043e\u0439\u0441\u0442\u0432 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0434\u0432\u0430 \u043d\u0430\u00a0\u0432\u044b\u0431\u043e\u0440:\u00a0<code>parensStyle<\/code>\u00a0\u0438\u00a0<code>goStyle<\/code> <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043e\u0434\u0438\u043d<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">Content\u2011Type <\/p>\n<\/td>\n<td>\n<p align=\"left\">mime \u043f\u0440\u044f\u043c\u043e \u0432\u00a0\u0441\u0442\u0440\u043e\u043a\u0435 \u0442\u0435\u0433\u0430:\u00a0<code>@Success 200 json ...<\/code> <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u0442\u0435\u0433\u0438\u00a0<code>@Accept<\/code>\u00a0\/\u00a0<code>@Produce<\/code> <\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\">\u041c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 API <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0431\u043b\u043e\u043a\u00a0<code>@Info<\/code>\u00a0\u0432\u00a0\u043b\u044e\u0431\u043e\u043c \u0444\u0430\u0439\u043b\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 <\/p>\n<\/td>\n<td>\n<p align=\"left\">\u043f\u0440\u0438\u0432\u044f\u0437\u043a\u0430 \u043a\u00a0\u043e\u0431\u0449\u0435\u043c\u0443 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044e (\u043e\u0431\u044b\u0447\u043d\u043e \u0432\u00a0<code>main.go<\/code>) <\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<h2>\u041a\u0430\u043a\u00a0\u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0446\u0435\u043b\u0438\u043a\u043e\u043c<\/h2>\n<p>\u0412\u00a0\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0435\u0441\u0442\u044c \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044f <a href=\"https:\/\/gitlab.com\/torenter\/genoas\/-\/tree\/main\/for_test\" rel=\"noopener nofollow\">for_test<\/a>\u00a0\u2014 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u043c\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0435\u0439 genoas: query, path \u0438 header\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, \u0442\u0435\u043b\u0430 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0438 \u043e\u0442\u0432\u0435\u0442\u043e\u0432, \u043c\u0430\u0441\u0441\u0438\u0432\u044b, \u043c\u0430\u043f\u044b, \u0434\u0436\u0435\u043d\u0435\u0440\u0438\u043a\u0438, \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c, \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0430 \u0444\u0430\u0439\u043b\u043e\u0432.<\/p>\n<p>\u0410\u00a0\u0440\u044f\u0434\u043e\u043c \u043b\u0435\u0436\u0438\u0442 <a href=\"https:\/\/gitlab.com\/torenter\/genoas\/-\/blob\/main\/for_test\/oas_golden.yml\" rel=\"noopener nofollow\">oas_golden.yml<\/a>\u00a0\u2014 \u00ab\u0437\u043e\u043b\u043e\u0442\u0430\u044f\u00bb \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f, \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u0430\u044f \u043f\u043e\u00a0\u044d\u0442\u0438\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0430\u043c. \u041f\u043e\u00a0\u043d\u0435\u0439 \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c, \u043a\u0430\u043a\u043e\u0439 YAML \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0441\u044f \u043d\u0430\u00a0\u0432\u044b\u0445\u043e\u0434\u0435, \u043d\u0435\u00a0\u0443\u0441\u0442\u0430\u043d\u0430\u0432\u043b\u0438\u0432\u0430\u044f \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442.<\/p>\n<p>\u0417\u0430\u043e\u0434\u043d\u043e \u044d\u0442\u043e e2e\u2011\u0442\u0435\u0441\u0442: <code>make golden-check<\/code> \u043f\u0440\u043e\u0433\u043e\u043d\u044f\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043f\u043e <code>for_test<\/code> \u0438 \u043f\u043e\u0431\u0430\u0439\u0442\u043e\u0432\u043e \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0441\u00a0\u044d\u0442\u0430\u043b\u043e\u043d\u043e\u043c. \u041b\u044e\u0431\u043e\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435 \u0432\u00a0\u043f\u0430\u0440\u0441\u0435\u0440\u0430\u0445, \u043d\u0435\u0437\u0430\u043c\u0435\u0442\u043d\u043e \u043f\u043e\u043c\u0435\u043d\u044f\u0432\u0448\u0435\u0435 \u0432\u044b\u0432\u043e\u0434, \u0441\u0440\u0430\u0437\u0443 \u0432\u0441\u043f\u043b\u044b\u0432\u0451\u0442 \u0432\u00a0\u0434\u0438\u0444\u0444\u0435.<\/p>\n<h2>\u0427\u0435\u0433\u043e \u0435\u0449\u0451 \u043d\u0435\u0442<\/h2>\n<p>\u2014 <code>discriminator<\/code> \u0434\u043b\u044f\u00a0\u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u043d\u044b\u0445 \u0441\u0445\u0435\u043c;<\/p>\n<p>\u2014 <code>example<\/code> \/ <code>examples<\/code> \u043d\u0430\u00a0\u0443\u0440\u043e\u0432\u043d\u0435 media type \u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432 (\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u0440\u0438\u043c\u0435\u0440\u044b);<\/p>\n<p>\u2014 <code>security<\/code> \u043d\u0430\u00a0\u0443\u0440\u043e\u0432\u043d\u0435 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 (<code>@Security<\/code> \u043d\u0430\u00a0\u0440\u0443\u0447\u043a\u0443);<\/p>\n<p>\u2014 <code>encoding<\/code> \u0434\u043b\u044f\u00a0multipart\/form\u2011data (content\u2011type \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0445 \u0447\u0430\u0441\u0442\u0435\u0439 \u0444\u043e\u0440\u043c\u044b);<\/p>\n<p>\u2014 <code>application\/x-www-form-urlencoded<\/code> \u0434\u043b\u044f\u00a0\u0442\u0435\u043b\u0430 \u0437\u0430\u043f\u0440\u043e\u0441\u0430;<\/p>\n<p>\u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 query\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432: <code>allowEmptyValue<\/code>, <code>allowReserved<\/code>, \u043c\u0430\u0441\u0441\u0438\u0432\u044b \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440, content\u2011\u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f;<\/p>\n<p>\u2014 path\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0442\u0438\u043f\u043e\u0432 boolean \u0438 \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u0432 (\u0441\u0435\u0439\u0447\u0430\u0441\u00a0\u2014 \u0447\u0438\u0441\u043b\u0430 \u0438 \u0441\u0442\u0440\u043e\u043a\u0438).<\/p>\n<p>\u2014 <code>@Cookie<\/code>\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, <code>variables<\/code> \u0432\u00a0\u0441\u0435\u0440\u0432\u0435\u0440\u0430\u0445;<\/p>\n<p>\u2014 <code>dependentRequired<\/code>, <code>patternProperties<\/code>, <code>not<\/code>, <code>callbacks<\/code>, <code>xml<\/code>\u2011\u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435;<\/p>\n<p>\u2014 <code>webhooks<\/code>, <code>links<\/code>, <code>externalDocs<\/code>, <code>jsonSchemaDialect<\/code>, <code>components.pathItems<\/code>;<\/p>\n<p>\u2014 HTTP\u2011\u043c\u0435\u0442\u043e\u0434 <code>trace<\/code>, <code>prefixItems<\/code>, <code>contains<\/code>, <code>if<\/code>\/<code>then<\/code>\/<code>else<\/code>;<\/p>\n<p>\u2014 x\u2011\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f (<code>x-...<\/code>), drop\u2011in \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441\u00a0\u043f\u043e\u043f\u0443\u043b\u044f\u0440\u043d\u044b\u043c\u0438 \u0442\u0435\u0433\u0430\u043c\u0438 swag (<code>@Accept<\/code>\/<code>@Produce<\/code>).<\/p>\n<p>\u0414\u043e\u043f\u0443\u0441\u043a\u0430\u044e, \u0447\u0442\u043e\u00a0\u0441\u043f\u0438\u0441\u043e\u043a \u043d\u0435\u043f\u043e\u043b\u043d\u044b\u0439.<\/p>\n<h2>\u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/h2>\n<p>\u041d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043a\u043e\u0434\u0430 \u0437\u0430\u043d\u044f\u043b\u043e \u0434\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u0434\u043b\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u0441\u00a0\u0443\u0447\u0451\u0442\u043e\u043c \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u0440\u0430\u0431\u043e\u0442\u044b(\u0441 \u0444\u0435\u0432\u0440\u0430\u043b\u044f \u043f\u043e\u00a0\u0441\u0435\u0433\u043e\u0434\u043d\u044f). \u0414\u0430\u00a0\u0438 \u0434\u043b\u044f\u00a0\u043a\u043e\u043b\u043b\u0435\u0433 \u0438\u0437\u00a0\u0431\u0430\u043d\u043a\u0430 \u044d\u0442\u043e \u0441\u0442\u0430\u043b\u043e \u043d\u0435\u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e: \u043a\u0430\u043a\u00a0\u044f \u043f\u043e\u0437\u0436\u0435 \u0443\u0437\u043d\u0430\u043b, \u0442\u0430\u043c \u0441\u0442\u0430\u043b\u0438 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u043e\u0442\u00a0\u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0433\u043e\u00a0\u2014 \u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u0440\u0443\u043a\u0430\u043c\u0438 \u0441\u0432\u0430\u0433\u0435\u0440, \u043f\u043e\u0442\u043e\u043c \u043f\u043e\u00a0\u043d\u0435\u043c\u0443 \u0431\u044d\u043a\u0435\u043d\u0434. \u0412\u00a0\u043a\u0430\u043a\u043e\u0439\u2011\u0442\u043e \u043c\u043e\u043c\u0435\u043d\u0442 \u0443\u00a0\u043c\u0435\u043d\u044f \u0438 \u0432\u043e\u0432\u0441\u0435 \u0437\u0430\u043a\u043e\u043d\u0447\u0438\u043b\u0430\u0441\u044c \u043c\u043e\u0442\u0438\u0432\u0430\u0446\u0438\u044f, \u043d\u043e\u00a0\u044f \u0440\u0435\u0448\u0438\u043b, \u0447\u0442\u043e\u00a0\u0434\u043e\u0432\u0435\u0434\u0443 \u0434\u0435\u043b\u043e \u0434\u043e\u00a0\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0451\u043d\u043d\u043e\u0439 \u0441\u0442\u0430\u0434\u0438\u0438 \u0433\u043e\u0442\u043e\u0432\u043d\u043e\u0441\u0442\u0438.<\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0431\u0443\u0434\u0443 \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u0435\u043d \u0437\u0430\u00a0\u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u0432\u044f\u0437\u044c, \u0438 \u0435\u0441\u043b\u0438 \u043f\u0440\u043e\u0435\u043a\u0442 \u043e\u043a\u0430\u0436\u0435\u0442\u0441\u044f \u0432\u043e\u0441\u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u043d\u044b\u043c, \u0442\u043e \u0431\u0443\u0434\u0443 \u0440\u0430\u0434 \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0438\u0442\u044c \u043d\u0430\u0434 \u043d\u0438\u043c \u0440\u0430\u0431\u043e\u0442\u0443. \u0421\u043e\u0433\u043b\u0430\u0441\u0438\u0442\u0435\u0441\u044c, \u043d\u0435\u00a0\u0432\u0441\u0435\u0433\u0434\u0430 \u043f\u0440\u0438\u044f\u0442\u043d\u043e \u0447\u0442\u043e\u2011\u0442\u043e \u0434\u0435\u043b\u0430\u0442\u044c \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u00a0\u0441\u0442\u043e\u043b =)<\/p>\n<p>\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430\u00a0\u043f\u0440\u043e\u0435\u043a\u0442\u00a0\u2014 <a href=\"https:\/\/pkg.go.dev\/gitlab.com\/torenter\/genoas\" rel=\"noopener nofollow\">pkg.go.dev<\/a> \u0438 <a href=\"https:\/\/gitlab.com\/torenter\/genoas\" rel=\"noopener nofollow\">GitLab<\/a>. \u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f\u00a0\u2014 <a href=\"https:\/\/gitlab.com\/torenter\/genoas\/-\/blob\/main\/doc\/home.md\" rel=\"noopener nofollow\">\u0437\u0434\u0435\u0441\u044c<\/a>.<\/p>\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\/articles\/1095222\/\">https:\/\/habr.com\/ru\/articles\/1095222\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u0412\u0441\u0435\u043c \u043f\u0440\u0438\u0432\u0435\u0442!\u041c\u0435\u043d\u044f \u0437\u043e\u0432\u0443\u0442 \u0415\u0433\u043e\u0440, \u0438 \u044f \u0443\u0436\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u0435\u0442 \u043f\u0438\u0448\u0443 \u043d\u0430\u00a0Go.\u0421\u0435\u0433\u043e\u0434\u043d\u044f \u044f \u0445\u043e\u0442\u0435\u043b\u00a0\u0431\u044b \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0441\u0432\u043e\u0439 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u043f\u043e\u00a0\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u0441\u0432\u0430\u0433\u0435\u0440\u0430 \u0434\u043b\u044f\u00a0Go\u2011\u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432.\u0421\u00a0\u0447\u0435\u0433\u043e \u0432\u0441\u0451 \u043d\u0430\u0447\u0430\u043b\u043e\u0441\u044c\u041a\u043e\u0433\u0434\u0430 \u044f \u0440\u0430\u0431\u043e\u0442\u0430\u043b \u0432\u00a0\u0431\u0430\u043d\u043a\u0435, \u0443\u00a0\u043d\u0430\u0441 \u0431\u044b\u043b\u0438 \u0436\u0451\u0441\u0442\u043a\u0438\u0435 \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f: API \u0431\u044d\u043a\u0435\u043d\u0434\u0430 \u0434\u043e\u043b\u0436\u043d\u043e \u0431\u044b\u0442\u044c \u0434\u043e\u0441\u043a\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043e. \u041f\u0430\u0442\u0442\u0435\u0440\u043d\u044b \u0434\u043b\u044f\u00a0\u0441\u0442\u0440\u043e\u043a, \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f\/\u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0434\u043b\u0438\u043d\u0430 \u0438 \u0442\u0430\u043a \u0434\u0430\u043b\u0435\u0435. \u041d\u043e\u00a0\u0433\u043b\u0430\u0432\u043d\u043e\u0435\u00a0\u2014 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u0434\u043e\u043b\u0436\u043d\u0430 \u0431\u044b\u043b\u0430 \u0431\u044b\u0442\u044c \u0432\u0435\u0440\u0441\u0438\u0438 \u043d\u0435\u00a0\u043d\u0438\u0436\u0435 3.0.\u041a\u00a0\u0441\u043e\u0436\u0430\u043b\u0435\u043d\u0438\u044e, \u043f\u043e\u0434\u0445\u043e\u0434\u044f\u0449\u0438\u0445 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a \u043d\u0430\u00a0\u0442\u043e\u0442 \u043c\u043e\u043c\u0435\u043d\u0442 \u0431\u044b\u043b\u043e \u043d\u0435\u00a0\u0442\u043e \u0447\u0442\u043e\u0431\u044b \u043c\u043d\u043e\u0433\u043e. \u042f \u0443\u0436\u0435 \u043d\u0435\u00a0\u0433\u043e\u0432\u043e\u0440\u044e \u043e\u00a0\u0442\u043e\u043c, \u043f\u043e\u0434\u0445\u043e\u0434\u0438\u043b\u0438\u00a0\u043b\u0438 \u043e\u043d\u0438 \u043d\u0430\u043c \u0432\u043e\u043e\u0431\u0449\u0435. \u041a\u043e\u043d\u0435\u0447\u043d\u043e, \u0431\u044b\u043b swaggo\/swag, \u043d\u043e\u00a0\u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 3.0\u00a0\u0442\u043e\u0433\u0434\u0430 \u0431\u044b\u043b\u0430 \u0442\u043e\u043b\u044c\u043a\u043e \u0432\u00a0\u0437\u0430\u0447\u0430\u0442\u043a\u0435.\u041c\u044b \u0432\u044b\u0431\u0440\u0430\u043b\u0438 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 go\u2011swagger3, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043d\u0430\u00a0\u0442\u043e\u0442 \u043c\u043e\u043c\u0435\u043d\u0442 \u0443\u0436\u0435 \u0434\u043e\u043b\u0433\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u043d\u0435\u00a0\u043e\u0431\u043d\u043e\u0432\u043b\u044f\u043b\u0430\u0441\u044c, \u043d\u043e\u00a0\u0432\u00a0\u0446\u0435\u043b\u043e\u043c \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u043b\u0430 \u0431\u044b\u0441\u0442\u0440\u043e \u0437\u0430\u043b\u0430\u0442\u0430\u0442\u044c \u0434\u044b\u0440\u0443 \u0441\u00a0\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 API. \u0418 \u0432\u0441\u0451\u00a0\u0431\u044b \u0442\u0430\u043a \u0438 \u043e\u0441\u0442\u0430\u0432\u0430\u043b\u043e\u0441\u044c, \u043d\u043e\u00a0\u0432\u00a0\u043a\u0430\u043a\u043e\u0439\u2011\u0442\u043e \u043c\u043e\u043c\u0435\u043d\u0442 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0440\u0443\u0447\u0435\u043a \u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0439 \u043a\u00a0\u043d\u0438\u043c \u043d\u0430\u0447\u0430\u043b\u043e \u043b\u043e\u043c\u0430\u0442\u044c \u0435\u0435: \u043f\u0440\u043e\u043f\u0430\u0434\u0430\u043b\u0438 \u0446\u0435\u043b\u044b\u0435 \u043a\u0443\u0441\u043a\u0438 \u0441\u043f\u0435\u043a\u0438, \u0442\u043e\u0447\u0435\u0447\u043d\u043e \u0442\u0435\u0440\u044f\u043b\u0438\u0441\u044c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u043f\u043e\u043b\u0435\u0439 \u0438 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f. \u0412\u0441\u0451 \u0447\u0430\u0449\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u043b\u043e\u0441\u044c \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c, \u0447\u0442\u043e\u00a0\u0438\u043c\u0435\u043d\u043d\u043e \u0438\u0437\u043c\u0435\u043d\u0438\u043b\u043e\u0441\u044c \u0432\u00a0\u0441\u0432\u0430\u0433\u0435\u0440\u0435 \u043f\u043e\u0441\u043b\u0435 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438,\u00a0\u2014 \u0438\u043b\u0438\u00a0\u0432\u043e\u0432\u0441\u0435 \u043f\u0440\u0430\u0432\u0438\u0442\u044c \u0435\u0433\u043e \u0440\u0443\u043a\u0430\u043c\u0438. \u041f\u043b\u044e\u0441 \u043e\u043d\u0430 \u043d\u0435\u00a0\u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u043b\u0430 \u043d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u0435\u0449\u0438\u00a0\u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043e\u0442\u0432\u0435\u0442 \u0432\u00a0\u0432\u0438\u0434\u0435 \u0441\u0442\u0440\u043e\u043a\u0438.\u041a\u00a0\u0442\u043e\u043c\u0443\u00a0\u0436\u0435, \u0447\u0442\u043e\u00a0\u0432\u00a0swag, \u0447\u0442\u043e\u00a0\u0432\u00a0go\u2011swagger3, \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0438 \u043a\u00a0\u0440\u0443\u0447\u043a\u0430\u043c, \u043b\u0438\u0447\u043d\u043e \u043d\u0430\u00a0\u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434\u00a0\u2014 \u043f\u0435\u0440\u0435\u0433\u0440\u0443\u0436\u0435\u043d\u044b.\u0422\u043e\u0433\u0434\u0430 \u044f \u0440\u0435\u0448\u0438\u043b \u0432\u0437\u044f\u0442\u044c\u0441\u044f \u0437\u0430\u00a0\u0435\u0451 \u0430\u043a\u0442\u0443\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044e \u0438 \u0443\u043f\u0440\u043e\u0449\u0435\u043d\u0438\u0435, \u043d\u043e\u00a0\u0431\u044b\u0441\u0442\u0440\u043e \u043f\u043e\u043d\u044f\u043b, \u0447\u0442\u043e\u00a0\u0434\u0435\u043b\u043e \u044d\u0442\u043e \u0433\u0438\u0431\u043b\u043e\u0435. \u0422\u0430\u043a \u044f \u043d\u0430\u0447\u0430\u043b \u043f\u043e\u0442\u0438\u0445\u043e\u043d\u044c\u043a\u0443 \u043f\u0438\u043b\u0438\u0442\u044c \u0441\u0432\u043e\u044e \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044e.\u0427\u0442\u043e\u00a0\u043f\u043e\u043b\u0443\u0447\u0438\u043b\u043e\u0441\u044c\u0415\u0441\u043b\u0438 \u0432\u044b \u043f\u044b\u0442\u0430\u043b\u0438\u0441\u044c \u0440\u0430\u0437\u043e\u0431\u0440\u0430\u0442\u044c\u0441\u044f \u0432\u00a0\u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u0430\u0445 swag\u00a0\u2014 \u0434\u0443\u043c\u0430\u044e, \u0441\u043e\u0433\u043b\u0430\u0441\u0438\u0442\u0435\u0441\u044c \u043d\u0430\u00a0\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u044d\u0442\u043e \u0442\u0440\u0443\u0434\u043d\u043e \u0438 \u0434\u043e\u043b\u0433\u043e. \u0412\u00a0\u0441\u0432\u043e\u0451\u043c \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u044f \u043f\u043e\u0441\u0442\u0430\u0440\u0430\u043b\u0441\u044f \u0443\u043f\u0440\u043e\u0441\u0442\u0438\u0442\u044c \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0435\u0432, \u043e\u0442\u043a\u0430\u0437\u0430\u0442\u044c\u0441\u044f \u043e\u0442\u00a0\u0440\u0443\u0447\u043d\u043e\u0433\u043e \u043f\u0430\u0440\u0441\u0438\u043d\u0433\u0430 \u0442\u0438\u043f\u043e\u0432 \u0438 \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u043f\u0440\u0438\u00a0\u044d\u0442\u043e\u043c \u0432\u0441\u0451 \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u00a0\u043f\u043b\u0430\u043d\u0435 \u043a\u043e\u0434\u0430.\u0414\u043b\u044f\u00a0\u044d\u0442\u043e\u0433\u043e \u043f\u0440\u0438\u0448\u043b\u043e\u0441\u044c \u0440\u0430\u0437\u0431\u0438\u0442\u044c \u0432\u0441\u0451 \u043d\u0430\u00a0\u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0441\u0435\u0440\u044b \u0438 \u0432\u044b\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0438\u0437\u00a0\u043d\u0438\u0445 \u043a\u043e\u043d\u0432\u0435\u0439\u0435\u0440. \u0422\u0430\u043a\u0436\u0435 \u043c\u043d\u0435 \u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c, \u0447\u0442\u043e\u0431\u044b \u043f\u0440\u043e\u0435\u043a\u0442 \u043c\u043e\u0436\u043d\u043e \u0431\u044b\u043b\u043e \u0440\u0430\u0441\u0448\u0438\u0440\u044f\u0442\u044c \u0438\u043b\u0438\u00a0\u0437\u0430\u043c\u0435\u043d\u044f\u0442\u044c \u043a\u0430\u043a\u0438\u0435\u2011\u0442\u043e \u0435\u0433\u043e \u0447\u0430\u0441\u0442\u0438, \u0435\u0441\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044e \u0432\u0434\u0440\u0443\u0433 \u043d\u0435\u00a0\u043f\u043e\u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f, \u043a\u0430\u043a\u00a0\u043f\u0430\u0440\u0441\u0438\u0442\u0441\u044f, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0442\u0435\u043b\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u0438\u0437\u00a0\u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f.\u0412\u043e\u0442 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u0442\u043e\u0433\u043e, \u043a\u0430\u043a\u00a0\u0443\u0434\u0430\u043b\u043e\u0441\u044c \u0443\u043f\u0440\u043e\u0441\u0442\u0438\u0442\u044c \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0435\u0432, \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u0432 \u0447\u0438\u0442\u0430\u0435\u043c\u043e\u0441\u0442\u044c:P.\u202fS. \u0417\u0434\u0435\u0441\u044c \u0438 \u0434\u0430\u043b\u0435\u0435 \u044f \u0431\u0443\u0434\u0443 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0442\u044c \u0441\u043e swag \u043a\u0430\u043a\u00a0\u0441\u00a0\u044d\u0442\u0430\u043b\u043e\u043d\u043e\u043c.\/\/ swag:\/\/ @Summary \u0421\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432\/\/ @Param   limit  query    int  false  &#171;\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439&#187;\/\/ @Success 200    {array}  models.Pet  &#171;\u0441\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432&#187;\/\/ @Produce json\/\/ @Router  \/pets [get]\/\/ genoas:\/\/ @Title    \u0421\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432\/\/ @Query    limit  int       example(20) description(\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439)\/\/ @Success  200    json      []models.Pet  description(\u0441\u043f\u0438\u0441\u043e\u043a \u043f\u0438\u0442\u043e\u043c\u0446\u0435\u0432)\/\/ @Route    \/pets [get]\u0415\u0449\u0435 \u043f\u0440\u0438\u043c\u0435\u0440: \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0438 \u043e\u0442\u0432\u0435\u0442\u0430. \u0412\u00a0swag \u043e\u043d\u0438 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u0442\u0430\u043a: \/\/ @Header 200 {string} Token &#171;token&#187;\u0412\u00a0genoas \u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:\/\/ @Header.Response  200  X-Request-Id  string  example(3fa85f64)  description(\u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0437\u0430\u043f\u0440\u043e\u0441\u0430)\u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u043d\u044b\u0435 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0437\u0430\u043c\u0435\u043d\u0435\u043d\u044b \u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438. \u041b\u0438\u0447\u043d\u043e \u044f \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u043e \u043f\u0443\u0442\u0430\u043b\u0441\u044f \u0432\u00a0\u0442\u043e\u043c, \u0447\u0442\u043e\u00a0\u0437\u0430\u00a0\u0447\u0435\u043c \u0434\u043e\u043b\u0436\u043d\u043e \u0438\u0434\u0442\u0438, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0440\u0435\u0448\u0438\u043b, \u0447\u0442\u043e\u00a0\u0441\u0442\u0440\u043e\u043a\u0443 \u043f\u0440\u043e\u0449\u0435 \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0442\u044c, \u0437\u043d\u0430\u044f \u0438\u043c\u0435\u043d\u0430 \u0441\u0432\u043e\u0439\u0441\u0442\u0432, \u0447\u0435\u043c \u043f\u0430\u0440\u0441\u0438\u0442\u044c \u043f\u043e\u0437\u0438\u0446\u0438\u0438 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043a\u0430\u043c\u0438, \u043a\u0430\u043a\u00a0\u044d\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442 swag,\u00a0\u2014 \u043f\u0443\u0441\u0442\u044c \u044d\u0442\u043e \u0438 \u043d\u0435\u043c\u043d\u043e\u0433\u043e \u043c\u043d\u043e\u0433\u043e\u0441\u043b\u043e\u0432\u043d\u0435\u0435.\u0421\u0430\u043c\u0438 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u043c\u043e\u0436\u043d\u043e \u043f\u0438\u0441\u0430\u0442\u044c \u0432\u00a0\u0434\u0432\u0443\u0445 \u0441\u0442\u0438\u043b\u044f\u0445\u00a0\u2014 \u043d\u0430\u00a0\u0432\u043a\u0443\u0441:\/\/ parensStyle (\u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e)\/\/ @Query  limit  int  minLength(1)  example(20)  description(\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439)\/\/ goStyle \u2014 \u043a\u0430\u043a \u0442\u0435\u0433\u0438 \u043f\u043e\u043b\u0435\u0439 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440 \u0432 Go\/\/ @Query  limit  int  minLength:&#187;1&#8243;  example:&#187;20&#187;  description:&#187;\u043c\u0430\u043a\u0441\u0438\u043c\u0443\u043c \u0437\u0430\u043f\u0438\u0441\u0435\u0439&#187;\u0421\u0442\u0438\u043b\u044c \u0432\u044b\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0444\u043b\u0430\u0433\u043e\u043c &#8212;comment-style.\u041e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043f\u0440\u043e\u00a0\u0442\u043e, \u043a\u0430\u043a\u00a0\u044d\u0442\u043e \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u043e \u0432\u043d\u0443\u0442\u0440\u0438. \u0418 swag, \u0438 go\u2011swagger3\u00a0\u0440\u0430\u0437\u0431\u0438\u0440\u0430\u044e\u0442 \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043d\u044b\u043c\u0438 \u0432\u044b\u0440\u0430\u0436\u0435\u043d\u0438\u044f\u043c\u0438. \u042f \u043f\u043e\u0448\u0435\u043b \u0434\u0440\u0443\u0433\u0438\u043c \u043f\u0443\u0442\u0451\u043c: \u0430\u0434\u0430\u043f\u0442\u0438\u0440\u043e\u0432\u0430\u043b reflect.StructTag \u0438\u0437\u00a0\u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u043e\u0439 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438, \u043d\u0430\u0443\u0447\u0438\u0432 \u0435\u0433\u043e \u0440\u0430\u0437\u0434\u0435\u043b\u044f\u0442\u044c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0442\u0430\u0431\u0443\u043b\u044f\u0446\u0438\u0435\u0439 \u0438 \u044d\u043a\u0440\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u0438\u043c\u0432\u043e\u043b\u044b \u0432\u00a0\u0441\u043a\u043e\u0431\u043e\u0447\u043d\u043e\u043c \u0441\u0442\u0438\u043b\u0435. \u0412\u043c\u0435\u0441\u0442\u043e \u0445\u0440\u0443\u043f\u043a\u0438\u0445 \u0440\u0435\u0433\u0435\u043a\u0441\u043e\u0432\u00a0\u2014 \u043f\u0440\u043e\u0441\u0442\u043e\u0439 \u0441\u043a\u0430\u043d\u0435\u0440 \u0432\u00a0\u0434\u0443\u0445\u0435 stdlib: \u043e\u043d \u043d\u0435\u00a0\u0441\u043b\u043e\u043c\u0430\u0435\u0442\u0441\u044f \u043e\u00a0\u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u0441\u00a0\u043f\u0440\u043e\u0431\u0435\u043b\u0430\u043c\u0438 \u0438\u043b\u0438\u00a0\u043a\u0430\u0432\u044b\u0447\u043a\u0430\u043c\u0438 \u0432\u043d\u0443\u0442\u0440\u0438. \u0427\u0435\u0441\u0442\u043d\u044b\u0445 \u0431\u0435\u043d\u0447\u043c\u0430\u0440\u043a\u043e\u0432 \u043d\u0435\u00a0\u0433\u043e\u043d\u044f\u043b, \u043d\u043e\u00a0\u043b\u0438\u043d\u0435\u0439\u043d\u044b\u0439 \u043f\u0440\u043e\u0445\u043e\u0434 \u043f\u043e\u00a0\u0441\u0442\u0440\u043e\u043a\u0435 \u0430\u043f\u0440\u0438\u043e\u0440\u0438 \u043d\u0435\u00a0\u0434\u043e\u0440\u043e\u0436\u0435 \u0440\u0435\u0433\u0435\u043a\u0441\u043e\u0432, \u0430\u00a0\u043f\u043e\u00a0\u043d\u0430\u0434\u0451\u0436\u043d\u043e\u0441\u0442\u0438 \u043d\u0430\u00a0\u0433\u0440\u0430\u043d\u0438\u0447\u043d\u044b\u0445 \u0441\u043b\u0443\u0447\u0430\u044f\u0445\u00a0\u2014 \u0437\u0430\u043c\u0435\u0442\u043d\u043e \u043f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u0435\u0435.\u041e\u0434\u0438\u043d \u0438\u0437\u00a0\u043f\u0443\u043d\u043a\u0442\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u0445\u043e\u0442\u0435\u043b \u0437\u0430\u043a\u0440\u044b\u0442\u044c,\u00a0\u2014 \u044d\u0442\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f. \u0427\u0435\u0441\u0442\u043d\u043e, \u044d\u0442\u043e \u043c\u043e\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0431\u043e\u043b\u044c: \u043a\u043e\u0433\u0434\u0430 \u0443\u00a0\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u043d\u0435\u0442 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u0434\u043e\u0434\u0443\u043c\u044b\u0432\u0430\u0442\u044c, \u043a\u0430\u043a\u00a0\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u0443 \u0438\u043b\u0438\u00a0\u0438\u043d\u0443\u044e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0443\u00a0genoas \u0441\u0442\u0430\u0440\u0430\u044e\u0441\u044c \u0432\u0435\u0441\u0442\u0438 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u0443\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0441\u00a0\u043f\u0440\u0438\u043c\u0435\u0440\u0430\u043c\u0438 \u043d\u0430\u00a0\u043a\u0430\u0436\u0434\u044b\u0439 \u0442\u0435\u0433 \u0438 \u043a\u0430\u0436\u0434\u044b\u0439 \u0442\u0438\u043f.\u041d\u0435\u00a0\u0431\u0443\u0434\u0443 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u043f\u0443\u043d\u043a\u0442\u00a0\u2014 \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u044e \u043a\u0440\u0430\u0442\u043a\u043e\u0435 \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u0435 \u0441\u043e swag:genoas swag \u0412\u0435\u0440\u0441\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 OpenAPI 3.1+\u00a0\u2014 \u043e\u0441\u043d\u043e\u0432\u043d\u0430\u044f \u0438 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u0430\u044f \u0446\u0435\u043b\u044c OpenAPI 2.0; 3.1\u00a0\u2014 \u044d\u043a\u0441\u043f\u0435\u0440\u0438\u043c\u0435\u043d\u0442\u0430\u043b\u044c\u043d\u044b\u0439 \u0444\u043b\u0430\u0433 \u0414\u0436\u0435\u043d\u0435\u0440\u0438\u043a\u0438 \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435 \u0438 \u043a\u0440\u043e\u0441\u0441\u2011\u043f\u0430\u043a\u0435\u0442\u043d\u044b\u0435; \u0442\u0438\u043f \u043f\u043e\u043b\u044f \u0432\u044b\u0447\u0438\u0441\u043b\u044f\u0435\u0442\u0441\u044f \u0432\u00a0\u0441\u043a\u043e\u0443\u043f\u0435 \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u044f \u043c\u043e\u0434\u0435\u043b\u0438 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442\u0441\u044f, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u0432\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435; \u043d\u0430\u00a0\u043a\u0440\u043e\u0441\u0441\u2011\u043f\u0430\u043a\u0435\u0442\u043d\u044b\u0445 \u043a\u0435\u0439\u0441\u0430\u0445 \u0435\u0441\u0442\u044c \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u0435 issue \u041f\u043e\u0434\u043c\u0435\u043d\u0430 \u0442\u0438\u043f\u0430 \u043f\u043e\u043b\u044f swaggerType, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u043a\u043e\u043c\u043f\u043e\u0437\u0438\u0446\u0438\u044e:\u00a0oneOf\u00a0\/\u00a0anyOf\u00a0\/\u00a0allOf\u00a0\u0447\u0435\u0440\u0435\u0437 \u043f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u0435\u043d\u0438\u0435 \u0442\u0438\u043f\u043e\u0432 swaggertype\u00a0\u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0441\u0442\u0430\u044f \u043f\u043e\u0434\u043c\u0435\u043d\u0430 multipart\/form\u2011data \u043f\u043e 3.1: \u043f\u0441\u0435\u0432\u0434\u043e\u0442\u0438\u043f\u00a0file,\u00a0contentMediaType,\u00a0contentEncoding formData\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0432\u00a0\u0441\u0442\u0438\u043b\u0435 2.0 \u041f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c \u043d\u0430\u00a0\u043f\u043e\u043b\u044f\u0445 \u0438 \u0442\u0435\u043b\u0430\u0445 oneOf\u00a0\/\u00a0anyOf\u00a0\/\u00a0allOf,\u00a0nullable\u00a0\u0432\u00a0\u0441\u0438\u043d\u0442\u0430\u043a\u0441\u0438\u0441\u0435 3.1 \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u043d\u043e \u041f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u043e\u0441\u0442\u044c \u0432\u044b\u0432\u043e\u0434\u0430 \u0442\u0430\u0431\u043b\u0438\u0447\u043d\u044b\u0435 unit\u2011\u0442\u0435\u0441\u0442\u044b \u0432\u0441\u0435\u0445 \u043f\u0430\u0440\u0441\u0435\u0440\u043e\u0432 + \u0434\u0435\u0442\u0435\u0440\u043c\u0438\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 e2e\u2011\u0433\u0435\u0439\u0442 (make golden-check) \u2014 \u041f\u043e\u0442\u0440\u0435\u0431\u043b\u0435\u043d\u0438\u0435 \u043f\u0430\u043c\u044f\u0442\u0438 \u043b\u0451\u0433\u043a\u0430\u044f \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0430 \u043f\u0430\u043a\u0435\u0442\u043e\u0432 (~300\u00a0\u041c\u0411 \u043d\u0430\u00a0\u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445) \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0435 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u044b \u0441\u00a0OOM \u043d\u0430\u00a0\u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445 \u0417\u0440\u0435\u043b\u043e\u0441\u0442\u044c \u0438 \u044d\u043a\u043e\u0441\u0438\u0441\u0442\u0435\u043c\u0430 \u043c\u043e\u043b\u043e\u0434\u043e\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u0437\u0440\u0435\u043b\u044b\u0439: \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0438 \u0441\u00a0gin\/echo\/fiber, \u043e\u0433\u0440\u043e\u043c\u043d\u043e\u0435 \u0441\u043e\u043e\u0431\u0449\u0435\u0441\u0442\u0432\u043e \u041f\u043e\u043b\u043d\u043e\u0442\u0430 \u043f\u043e\u043a\u0440\u044b\u0442\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0440\u0430\u0441\u0442\u0451\u0442 \u0448\u0438\u0440\u0435, \u043d\u043e\u00a0\u0432\u00a0\u0440\u0430\u043c\u043a\u0430\u0445 2.0 x\u2011\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f (x-&#8230;) \u043f\u043e\u043a\u0430 \u043d\u0435\u0442 \u0435\u0441\u0442\u044c \u0422\u0438\u043f\u044b \u0432\u00a0\u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 Go\u2011\u0442\u0438\u043f\u044b \u043a\u0430\u043a\u00a0\u0435\u0441\u0442\u044c:\u00a0[]models.Pet,\u00a0map[string]int,\u00a0GenericModel[A,B] \u0441\u0432\u043e\u044f \u043d\u043e\u0442\u0430\u0446\u0438\u044f:\u00a0{object},\u00a0{array}\u00a0\u2014 \u0442\u0438\u043f \u0442\u0440\u0430\u043d\u0441\u043b\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432\u0440\u0443\u0447\u043d\u0443\u044e \u0421\u0432\u043e\u0439\u0441\u0442\u0432\u0430 \u0442\u0435\u0433\u043e\u0432 \u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u0435, \u0432\u00a0\u043b\u044e\u0431\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435:\u00a0description(&#8230;) example(20) \u043f\u043e\u0437\u0438\u0446\u0438\u043e\u043d\u043d\u044b\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b:\u00a0@Param id path int true &#171;Pet ID&#187; \u0421\u0442\u0438\u043b\u0438 \u0437\u0430\u043f\u0438\u0441\u0438 \u0441\u0432\u043e\u0439\u0441\u0442\u0432 \u0434\u0432\u0430 \u043d\u0430\u00a0\u0432\u044b\u0431\u043e\u0440:\u00a0parensStyle\u00a0\u0438\u00a0goStyle \u043e\u0434\u0438\u043dContent\u2011Type mime \u043f\u0440\u044f\u043c\u043e \u0432\u00a0\u0441\u0442\u0440\u043e\u043a\u0435 \u0442\u0435\u0433\u0430:\u00a0@Success 200 json &#8230; \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u0442\u0435\u0433\u0438\u00a0@Accept\u00a0\/\u00a0@Produce \u041c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435 API \u0431\u043b\u043e\u043a\u00a0@Info\u00a0\u0432\u00a0\u043b\u044e\u0431\u043e\u043c \u0444\u0430\u0439\u043b\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u043f\u0440\u0438\u0432\u044f\u0437\u043a\u0430 \u043a\u00a0\u043e\u0431\u0449\u0435\u043c\u0443 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044e (\u043e\u0431\u044b\u0447\u043d\u043e \u0432\u00a0main.go) \u041a\u0430\u043a\u00a0\u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0446\u0435\u043b\u0438\u043a\u043e\u043c\u0412\u00a0\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u0435\u0441\u0442\u044c \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044f for_test\u00a0\u2014 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u043c\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0435\u0439 genoas: query, path \u0438 header\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, \u0442\u0435\u043b\u0430 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0438 \u043e\u0442\u0432\u0435\u0442\u043e\u0432, \u043c\u0430\u0441\u0441\u0438\u0432\u044b, \u043c\u0430\u043f\u044b, \u0434\u0436\u0435\u043d\u0435\u0440\u0438\u043a\u0438, \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c, \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0430 \u0444\u0430\u0439\u043b\u043e\u0432.\u0410\u00a0\u0440\u044f\u0434\u043e\u043c \u043b\u0435\u0436\u0438\u0442 oas_golden.yml\u00a0\u2014 \u00ab\u0437\u043e\u043b\u043e\u0442\u0430\u044f\u00bb \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f, \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u0430\u044f \u043f\u043e\u00a0\u044d\u0442\u0438\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0430\u043c. \u041f\u043e\u00a0\u043d\u0435\u0439 \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c, \u043a\u0430\u043a\u043e\u0439 YAML \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0441\u044f \u043d\u0430\u00a0\u0432\u044b\u0445\u043e\u0434\u0435, \u043d\u0435\u00a0\u0443\u0441\u0442\u0430\u043d\u0430\u0432\u043b\u0438\u0432\u0430\u044f \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442.\u0417\u0430\u043e\u0434\u043d\u043e \u044d\u0442\u043e e2e\u2011\u0442\u0435\u0441\u0442: make golden-check \u043f\u0440\u043e\u0433\u043e\u043d\u044f\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043f\u043e for_test \u0438 \u043f\u043e\u0431\u0430\u0439\u0442\u043e\u0432\u043e \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0441\u00a0\u044d\u0442\u0430\u043b\u043e\u043d\u043e\u043c. \u041b\u044e\u0431\u043e\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435 \u0432\u00a0\u043f\u0430\u0440\u0441\u0435\u0440\u0430\u0445, \u043d\u0435\u0437\u0430\u043c\u0435\u0442\u043d\u043e \u043f\u043e\u043c\u0435\u043d\u044f\u0432\u0448\u0435\u0435 \u0432\u044b\u0432\u043e\u0434, \u0441\u0440\u0430\u0437\u0443 \u0432\u0441\u043f\u043b\u044b\u0432\u0451\u0442 \u0432\u00a0\u0434\u0438\u0444\u0444\u0435.\u0427\u0435\u0433\u043e \u0435\u0449\u0451 \u043d\u0435\u0442\u2014 discriminator \u0434\u043b\u044f\u00a0\u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u043d\u044b\u0445 \u0441\u0445\u0435\u043c;\u2014 example \/ examples \u043d\u0430\u00a0\u0443\u0440\u043e\u0432\u043d\u0435 media type \u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432 (\u0438\u043c\u0435\u043d\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u0440\u0438\u043c\u0435\u0440\u044b);\u2014 security \u043d\u0430\u00a0\u0443\u0440\u043e\u0432\u043d\u0435 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 (@Security \u043d\u0430\u00a0\u0440\u0443\u0447\u043a\u0443);\u2014 encoding \u0434\u043b\u044f\u00a0multipart\/form\u2011data (content\u2011type \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0445 \u0447\u0430\u0441\u0442\u0435\u0439 \u0444\u043e\u0440\u043c\u044b);\u2014 application\/x-www-form-urlencoded \u0434\u043b\u044f\u00a0\u0442\u0435\u043b\u0430 \u0437\u0430\u043f\u0440\u043e\u0441\u0430;\u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 query\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432: allowEmptyValue, allowReserved, \u043c\u0430\u0441\u0441\u0438\u0432\u044b \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440, content\u2011\u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f;\u2014 path\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0442\u0438\u043f\u043e\u0432 boolean \u0438 \u043c\u0430\u0441\u0441\u0438\u0432\u043e\u0432 (\u0441\u0435\u0439\u0447\u0430\u0441\u00a0\u2014 \u0447\u0438\u0441\u043b\u0430 \u0438 \u0441\u0442\u0440\u043e\u043a\u0438).\u2014 @Cookie\u2011\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, variables \u0432\u00a0\u0441\u0435\u0440\u0432\u0435\u0440\u0430\u0445;\u2014 dependentRequired, patternProperties, not, callbacks, xml\u2011\u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0435;\u2014 webhooks, links, externalDocs, jsonSchemaDialect, components.pathItems;\u2014 HTTP\u2011\u043c\u0435\u0442\u043e\u0434 trace, prefixItems, contains, if\/then\/else;\u2014 x\u2011\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f (x-&#8230;), drop\u2011in \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441\u00a0\u043f\u043e\u043f\u0443\u043b\u044f\u0440\u043d\u044b\u043c\u0438 \u0442\u0435\u0433\u0430\u043c\u0438 swag (@Accept\/@Produce).\u0414\u043e\u043f\u0443\u0441\u043a\u0430\u044e, \u0447\u0442\u043e\u00a0\u0441\u043f\u0438\u0441\u043e\u043a \u043d\u0435\u043f\u043e\u043b\u043d\u044b\u0439.\u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435\u041d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043a\u043e\u0434\u0430 \u0437\u0430\u043d\u044f\u043b\u043e \u0434\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u0434\u043b\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u0441\u00a0\u0443\u0447\u0451\u0442\u043e\u043c \u043e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u0440\u0430\u0431\u043e\u0442\u044b(\u0441 \u0444\u0435\u0432\u0440\u0430\u043b\u044f \u043f\u043e\u00a0\u0441\u0435\u0433\u043e\u0434\u043d\u044f). \u0414\u0430\u00a0\u0438 \u0434\u043b\u044f\u00a0\u043a\u043e\u043b\u043b\u0435\u0433 \u0438\u0437\u00a0\u0431\u0430\u043d\u043a\u0430 \u044d\u0442\u043e \u0441\u0442\u0430\u043b\u043e \u043d\u0435\u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e: \u043a\u0430\u043a\u00a0\u044f \u043f\u043e\u0437\u0436\u0435 \u0443\u0437\u043d\u0430\u043b, \u0442\u0430\u043c \u0441\u0442\u0430\u043b\u0438 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u043e\u0442\u00a0\u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0433\u043e\u00a0\u2014 \u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u0440\u0443\u043a\u0430\u043c\u0438 \u0441\u0432\u0430\u0433\u0435\u0440, \u043f\u043e\u0442\u043e\u043c \u043f\u043e\u00a0\u043d\u0435\u043c\u0443 \u0431\u044d\u043a\u0435\u043d\u0434. \u0412\u00a0\u043a\u0430\u043a\u043e\u0439\u2011\u0442\u043e \u043c\u043e\u043c\u0435\u043d\u0442 \u0443\u00a0\u043c\u0435\u043d\u044f \u0438 \u0432\u043e\u0432\u0441\u0435 \u0437\u0430\u043a\u043e\u043d\u0447\u0438\u043b\u0430\u0441\u044c \u043c\u043e\u0442\u0438\u0432\u0430\u0446\u0438\u044f, \u043d\u043e\u00a0\u044f \u0440\u0435\u0448\u0438\u043b, \u0447\u0442\u043e\u00a0\u0434\u043e\u0432\u0435\u0434\u0443 \u0434\u0435\u043b\u043e \u0434\u043e\u00a0\u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0451\u043d\u043d\u043e\u0439 \u0441\u0442\u0430\u0434\u0438\u0438 \u0433\u043e\u0442\u043e\u0432\u043d\u043e\u0441\u0442\u0438.\u0422\u0430\u043a\u0436\u0435 \u0431\u0443\u0434\u0443 \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u0435\u043d \u0437\u0430\u00a0\u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u0432\u044f\u0437\u044c, \u0438 \u0435\u0441\u043b\u0438 \u043f\u0440\u043e\u0435\u043a\u0442 \u043e\u043a\u0430\u0436\u0435\u0442\u0441\u044f \u0432\u043e\u0441\u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u043d\u044b\u043c, \u0442\u043e \u0431\u0443\u0434\u0443 \u0440\u0430\u0434 \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0438\u0442\u044c \u043d\u0430\u0434 \u043d\u0438\u043c \u0440\u0430\u0431\u043e\u0442\u0443. \u0421\u043e\u0433\u043b\u0430\u0441\u0438\u0442\u0435\u0441\u044c, \u043d\u0435\u00a0\u0432\u0441\u0435\u0433\u0434\u0430 \u043f\u0440\u0438\u044f\u0442\u043d\u043e \u0447\u0442\u043e\u2011\u0442\u043e \u0434\u0435\u043b\u0430\u0442\u044c \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u00a0\u0441\u0442\u043e\u043b =)\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430\u00a0\u043f\u0440\u043e\u0435\u043a\u0442\u00a0\u2014 pkg.go.dev \u0438 GitLab. \u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f\u00a0\u2014 \u0437\u0434\u0435\u0441\u044c.\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 https:\/\/habr.com\/ru\/articles\/1095222\/<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-498931","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/498931","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=498931"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/498931\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=498931"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=498931"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=498931"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}