{"id":482619,"date":"2026-06-06T09:46:19","date_gmt":"2026-06-06T09:46:19","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=482619"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=482619","title":{"rendered":"\u0412\u0438\u043a\u0438 \u0432\u0440\u0451\u0442, \u043f\u0440\u043e\u0434 \u043c\u043e\u043b\u0447\u0438\u0442: \u043f\u043e\u0447\u0435\u043c\u0443 \u043f\u043e\u0440\u0430 \u0441\u0434\u0435\u043b\u0430\u0442\u044c OpenAPI \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u043c \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u043e\u043c \u043f\u0440\u0430\u0432\u0434\u044b \u043e \u0432\u0430\u0448\u0435\u043c API"},"content":{"rendered":"
\n
\n

\u041a\u043e\u0440\u043e\u0442\u043a\u0430\u044f \u0441\u0443\u0442\u044c.<\/strong>\u00a0\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0434\u043e \u0441\u0438\u0445 \u043f\u043e\u0440 \u0445\u0440\u0430\u043d\u044f\u0442 \u00ab\u043f\u0440\u0430\u0432\u0434\u0443\u00bb \u043e\u0431 API \u0432 \u0442\u0440\u0451\u0445 \u043d\u0435\u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u044b\u0445 \u043c\u0435\u0441\u0442\u0430\u0445: \u0432 \u0433\u043e\u043b\u043e\u0432\u0435 \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440\u0430, \u0432 \u0441\u0442\u0440\u0430\u043d\u0438\u0447\u043a\u0435 Confluence, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0443\u0441\u0442\u0430\u0440\u0435\u043b\u0430 \u0435\u0449\u0451 \u043f\u0440\u043e\u0448\u043b\u043e\u0439 \u0432\u0435\u0441\u043d\u043e\u0439, \u0438 \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c JSON, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0438\u043b\u0435\u0442\u0430\u0435\u0442 \u0441 \u043f\u0440\u043e\u0434\u0430. \u042d\u0442\u0438 \u0442\u0440\u0438 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u043e \u0440\u0430\u0441\u0445\u043e\u0434\u044f\u0442\u0441\u044f, \u0438 \u0440\u0430\u0441\u043f\u043b\u0430\u0447\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u0437\u0430 \u044d\u0442\u043e \u0432\u0441\u0435 \u2014 \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438. OpenAPI \u2014 \u044d\u0442\u043e \u0441\u043f\u043e\u0441\u043e\u0431 \u0441\u0432\u0435\u0441\u0442\u0438 \u043f\u0440\u0430\u0432\u0434\u0443 \u043a \u043e\u0434\u043d\u043e\u043c\u0443 \u0444\u0430\u0439\u043b\u0443-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0443, \u043f\u043e\u043d\u044f\u0442\u043d\u043e\u043c\u0443 \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a\u0443, \u0438 \u043c\u0430\u0448\u0438\u043d\u0435. \u0412 \u0441\u0442\u0430\u0442\u044c\u0435 \u044f \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u044e, \u0437\u0430\u0447\u0435\u043c \u044d\u0442\u043e \u043d\u0443\u0436\u043d\u043e, \u043f\u043e\u0447\u0435\u043c\u0443 \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u2014 \u0434\u0430\u043b\u0435\u043a\u043e \u043d\u0435 \u0433\u043b\u0430\u0432\u043d\u0430\u044f \u043f\u0440\u0438\u0447\u0438\u043d\u0430, \u043d\u043e \u043f\u0440\u0438 \u044d\u0442\u043e\u043c \u043f\u0440\u043e\u0433\u043e\u0432\u0430\u0440\u0438\u0432\u0430\u044e, \u0432\u043e \u0447\u0442\u043e \u0432\u043d\u0435\u0434\u0440\u0435\u043d\u0438\u0435 \u043e\u0431\u043e\u0439\u0434\u0451\u0442\u0441\u044f \u0431\u044d\u043a\u0435\u043d\u0434\u0443, \u0438 \u0433\u0434\u0435 \u0443 \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u0441\u043b\u0430\u0431\u044b\u0435 \u043c\u0435\u0441\u0442\u0430.<\/p>\n<\/blockquote>\n

\u0421\u0438\u0442\u0443\u0430\u0446\u0438\u044f<\/h3>\n

\u042f \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a. \u0418\u043d\u043e\u0433\u0434\u0430 \u043f\u0440\u0438 \u0440\u0430\u0431\u043e\u0442\u0435 \u0441\u043e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430\u043c\u0438 \u0434\u0430\u043d\u043d\u044b\u0445 \u044f \u0438\u043c\u0435\u044e \u0434\u0435\u043b\u043e \u0441 endpoint-\u0430\u043c\u0438, \u0438\u0434\u0443 \u0432 \u0432\u0438\u043a\u0438, \u043d\u0430\u0445\u043e\u0436\u0443 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0443 \u0441 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435\u043c \u2014 \u0438 \u043d\u0435 \u0432\u0435\u0440\u044e \u0435\u0439. \u041f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043f\u043e \u043e\u043f\u044b\u0442\u0443 \u0437\u043d\u0430\u044e: \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 API \u0442\u0430\u043a\u0438\u043c, \u043a\u0430\u043a\u0438\u043c \u043e\u043d \u0431\u044b\u043b \u0437\u0430\u0434\u0443\u043c\u0430\u043d \u043f\u043e\u043b\u0433\u043e\u0434\u0430 \u043d\u0430\u0437\u0430\u0434, \u0430 \u043d\u0435 \u0442\u0430\u043a\u0438\u043c, \u043a\u0430\u043a\u043e\u0439 \u043e\u043d \u0441\u0435\u0439\u0447\u0430\u0441. \u0414\u0430\u043b\u044c\u0448\u0435 \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0437\u043d\u0430\u043a\u043e\u043c\u044b\u0439 \u0440\u0438\u0442\u0443\u0430\u043b: \u043f\u0438\u0448\u0443 \u0432 \u0447\u0430\u0442 \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440\u0443, \u043e\u043d \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u00ab\u0433\u043b\u044f\u043d\u044c \u0432 \u0441\u0432\u0430\u0433\u0433\u0435\u0440\u0435\u00bb, \u0441\u0432\u0430\u0433\u0433\u0435\u0440 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d \u0438\u0437 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0439 \u0438 \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u043f\u0440\u0438\u0431\u043b\u0438\u0437\u0438\u0442\u0435\u043b\u044c\u043d\u0443\u044e \u043a\u0430\u0440\u0442\u0438\u043d\u0443, \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u043e\u0442\u0432\u0435\u0442 \u0441 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u043e\u0442 \u043d\u0435\u0451 \u043e\u0442\u043b\u0438\u0447\u0430\u0435\u0442\u0441\u044f, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u043e \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0438 \u0436\u0438\u0432\u0451\u0442 \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435, \u0430 \u043f\u0440\u0430\u0432\u0438\u043b\u043e \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u2014 \u0432 \u0434\u0440\u0443\u0433\u043e\u043c. \u0412 \u0438\u0442\u043e\u0433\u0435 \u044f \u0434\u0435\u043b\u0430\u044e \u0442\u043e, \u0447\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0445 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432: \u0434\u0451\u0440\u0433\u0430\u044e endpoint \u00ab\u0432\u0436\u0438\u0432\u0443\u044e\u00bb, \u0441\u043c\u043e\u0442\u0440\u044e \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 JSON \u0438 \u0432\u0435\u0440\u044e \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u043c\u0443. \u0422\u043e \u0436\u0435 \u0441\u0430\u043c\u043e\u0435 \u0431\u044b\u0432\u0430\u0435\u0442 \u0438 \u043f\u0440\u0438 \u0440\u0430\u0431\u043e\u0442\u0435 \u0441 \u0432\u043d\u0435\u0448\u043d\u0438\u043c\u0438 API (\u0432 \u0442\u043e\u043c \u0447\u0438\u0441\u043b\u0435 \u0438 \u0441\u043e\u043b\u0438\u0434\u043d\u044b\u0445 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0439).<\/p>\n

\u042d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u043f\u0440\u0430\u0432\u0434\u044b. \u0423 \u043d\u0430\u0441 \u043d\u0435 \u043e\u0434\u0438\u043d \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a, \u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e, \u0438 \u043e\u043d\u0438 \u043a\u043e\u043d\u043a\u0443\u0440\u0438\u0440\u0443\u044e\u0442. \u0412\u0438\u043a\u0438 \u2014 \u044d\u0442\u043e \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u0438\u0435. \u041a\u043e\u0434 \u0431\u044d\u043a\u0435\u043d\u0434\u0430 \u2014 \u044d\u0442\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f. \u0420\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u0442\u0440\u0430\u0444\u0438\u043a \u2014 \u044d\u0442\u043e \u0444\u0430\u043a\u0442. \u0418 \u043a\u043e\u0433\u0434\u0430 \u043c\u0435\u0436\u0434\u0443 \u043d\u0438\u043c\u0438 \u0432\u043e\u0437\u043d\u0438\u043a\u0430\u0435\u0442 \u0440\u0430\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u0435 (\u0430 \u043e\u043d\u043e \u0432\u043e\u0437\u043d\u0438\u043a\u0430\u0435\u0442 \u0432\u0441\u0435\u0433\u0434\u0430), \u0446\u0435\u043d\u0430 \u043e\u0448\u0438\u0431\u043a\u0438 \u043b\u043e\u0436\u0438\u0442\u0441\u044f \u0432 \u043f\u0435\u0440\u0432\u0443\u044e \u043e\u0447\u0435\u0440\u0435\u0434\u044c \u043d\u0430 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044f API: \u043d\u0430 \u0444\u0440\u043e\u043d\u0442\u0435\u043d\u0434, \u043d\u0430 iOS, \u043d\u0430 Android, \u043d\u0430 \u0434\u0435\u0441\u043a\u0442\u043e\u043f, \u043d\u0430 \u0432\u043d\u0435\u0448\u043d\u0438\u0445 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0442\u043e\u0440\u043e\u0432.<\/p>\n

\u042d\u0442\u0443 \u0431\u043e\u043b\u044c \u043d\u0430 Habr \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u043b\u0438 \u043c\u043d\u043e\u0433\u0438\u0435. \u0410\u043b\u0435\u043a\u0441\u0435\u0439, Java-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u042eMoney, \u0432 \u0441\u0442\u0430\u0442\u044c\u0435 \u00ab\u041a\u0430\u043a \u0443\u043b\u0443\u0447\u0448\u0438\u0442\u044c \u043c\u0435\u0436\u0441\u0435\u0440\u0432\u0435\u0440\u043d\u043e\u0435 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0435 \u0438 \u0441\u044d\u043a\u043e\u043d\u043e\u043c\u0438\u0442\u044c \u0432\u0440\u0435\u043c\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430<\/a>\u00bb \u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u0443\u0435\u0442 \u0435\u0451 \u043f\u0440\u0435\u0434\u0435\u043b\u044c\u043d\u043e \u043f\u0440\u044f\u043c\u043e: \u00abSwagger UI, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u043e\u043c \u043f\u043e \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u043c \u043a\u043b\u0430\u0441\u0441\u043e\u0432, \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u043e\u0447\u0435\u043d\u044c \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u0443 \u043d\u0430\u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u043e\u0442\u0434\u0430\u0451\u0442\u0441\u044f \u0438\u0437 API. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0444\u0440\u043e\u043d\u0442\u044b \u0438 \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 \u043d\u0435 \u043c\u043e\u0433\u0443\u0442 \u043d\u0430\u0447\u0430\u0442\u044c \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0443, \u043d\u0435 \u0432\u044b\u0437\u0432\u0430\u0432 endpoint \u043d\u0430 \u0436\u0438\u0432\u0443\u044e\u00bb. \u042d\u0442\u043e \u043d\u0435 \u0447\u044c\u044f-\u0442\u043e \u043b\u0438\u0447\u043d\u0430\u044f \u043d\u0435\u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u043e\u0441\u0442\u044c \u2014 \u044d\u0442\u043e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u044b\u0439 \u0438\u0437\u044a\u044f\u043d \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0430, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043f\u0440\u0430\u0432\u0434\u0430 \u043d\u0435 \u0446\u0435\u043d\u0442\u0440\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u0430.<\/p>\n

\u0427\u0442\u043e \u0442\u0430\u043a\u043e\u0435 OpenAPI (\u0434\u043b\u044f \u0442\u0435\u0445, \u043a\u0442\u043e \u0435\u0449\u0451 \u043d\u0435 \u0441\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u043b\u0441\u044f)<\/h3>\n

OpenAPI \u2014 \u044d\u0442\u043e \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u0439 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f HTTP-API (\u043f\u0440\u0435\u0436\u0434\u0435 \u0432\u0441\u0435\u0433\u043e \u0432 REST-\u0441\u0442\u0438\u043b\u0435) \u0432 \u043c\u0430\u0448\u0438\u043d\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u043e\u043c \u0432\u0438\u0434\u0435. \u0421\u0442\u043e\u0438\u0442 \u0441\u0440\u0430\u0437\u0443 \u043e\u0447\u0435\u0440\u0442\u0438\u0442\u044c \u0433\u0440\u0430\u043d\u0438\u0446\u0443: OpenAPI \u2014 \u043d\u0435 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u044f\u0437\u044b\u043a \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 \u0438 \u043f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u043d\u0435 \u043b\u044e\u0431\u043e\u0439 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b. \u0414\u043b\u044f \u0441\u0442\u0440\u043e\u0433\u043e \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043c\u0435\u0436\u0441\u0435\u0440\u0432\u0438\u0441\u043d\u043e\u0433\u043e \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f \u0435\u0441\u0442\u044c gRPC \u0441 Protobuf, \u0434\u043b\u044f API \u0441 \u0433\u0438\u0431\u043a\u0438\u043c\u0438 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u043c\u0438 \u2014 GraphQL \u0441\u043e \u0441\u0432\u043e\u0435\u0439 \u0441\u0438\u0441\u0442\u0435\u043c\u043e\u0439 \u0442\u0438\u043f\u043e\u0432, \u0434\u043b\u044f \u0441\u043e\u0431\u044b\u0442\u0438\u0439\u043d\u044b\u0445 \u0438 \u0431\u0440\u043e\u043a\u0435\u0440\u043d\u044b\u0445 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440 (Kafka, \u043e\u0447\u0435\u0440\u0435\u0434\u0438 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0439) \u2014 \u0440\u043e\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442 AsyncAPI. OpenAPI \u0436\u0435 \u0437\u0430\u043d\u0438\u043c\u0430\u0435\u0442 \u043d\u0438\u0448\u0443 REST\/HTTP \u2014 \u0438 \u0438\u043c\u0435\u043d\u043d\u043e \u0437\u0434\u0435\u0441\u044c, \u0433\u0434\u0435 \u0436\u0438\u0432\u0451\u0442 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u043a\u043b\u0438\u0435\u043d\u0442-\u0441\u0435\u0440\u0432\u0435\u0440\u043d\u044b\u0445 API \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0445 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u043e\u0432, \u043e\u043d \u0441\u0442\u0430\u043b \u0434\u0435-\u0444\u0430\u043a\u0442\u043e \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043e\u043c. \u0420\u0430\u043d\u044c\u0448\u0435 \u043e\u043d \u043d\u0430\u0437\u044b\u0432\u0430\u043b\u0441\u044f Swagger; \u0432 \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435 2010-\u0445 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u043f\u0435\u0440\u0435\u0434\u0430\u043b\u0438 \u043f\u043e\u0434 \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0435 OpenAPI Initiative (\u043e\u0431\u044a\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u0435 \u043f\u043e\u0434 \u043a\u0440\u044b\u043b\u043e\u043c Linux Foundation, \u0443\u0447\u0440\u0435\u0436\u0434\u0451\u043d\u043d\u043e\u0435 \u0442\u0430\u043a\u0438\u043c\u0438 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044f\u043c\u0438, \u043a\u0430\u043a Google, IBM, Microsoft, PayPal, SmartBear \u0438 \u0434\u0440\u0443\u0433\u0438\u043c\u0438), \u0438 \u0441\u0435\u0433\u043e\u0434\u043d\u044f Swagger \u2014 \u044d\u0442\u043e \u0443\u0436\u0435 \u043d\u0430\u0431\u043e\u0440 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432 \u0432\u043e\u043a\u0440\u0443\u0433 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u0430 (Swagger UI, Swagger Editor \u0438 \u043f\u0440\u043e\u0447\u0438\u0435), \u0430 \u0441\u0430\u043c \u0444\u043e\u0440\u043c\u0430\u0442 \u043d\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f OpenAPI Specification.<\/p>\n

\u0422\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438 \u044d\u0442\u043e \u043e\u0434\u0438\u043d \u0444\u0430\u0439\u043b (\u043e\u0431\u044b\u0447\u043d\u043e YAML, \u0440\u0435\u0436\u0435 JSON), \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0432\u0441\u0451, \u0447\u0442\u043e \u043d\u0443\u0436\u043d\u043e \u0437\u043d\u0430\u0442\u044c \u043e REST API: \u043a\u0430\u043a\u0438\u0435 \u0435\u0441\u0442\u044c \u043f\u0443\u0442\u0438 (endpoints), \u043a\u0430\u043a\u0438\u0435 \u0443 \u043d\u0438\u0445 \u043c\u0435\u0442\u043e\u0434\u044b, \u043a\u0430\u043a\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0438 \u0442\u0435\u043b\u0430 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u043e\u043d\u0438 \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u044e\u0442, \u043a\u0430\u043a\u0438\u0435 \u043a\u043e\u0434\u044b \u043e\u0442\u0432\u0435\u0442\u043e\u0432 \u0438 \u043a\u0430\u043a\u0438\u0435 \u0441\u0445\u0435\u043c\u044b \u0434\u0430\u043d\u043d\u044b\u0445 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442, \u043a\u0430\u043a \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u0430 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f. \u0413\u043b\u0430\u0432\u043d\u043e\u0435 \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u0444\u043e\u0440\u043c\u0430\u0442, \u0430 \u0438\u0434\u0435\u044f: \u043e\u0434\u0438\u043d \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u043e \u0447\u0438\u0442\u0430\u044e\u0442 \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a, \u0438 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b.<\/p>\n

\u0412\u043e\u0442 \u043a\u0430\u043a \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u0440\u043e\u0441\u0442\u043e\u0433\u043e endpoint \u2014 \u0441\u0435\u0440\u0432\u0438\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0437\u0430\u0434\u0430\u0447\u0443 \u043f\u043e \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u0443:<\/p>\n

openapi: 3.1.0info:  title: TODO Service  version: 1.0.0paths:  \/tasks\/{taskId}:    get:      operationId: getTask      summary: \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0437\u0430\u0434\u0430\u0447\u0443 \u043f\u043e \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u0443      parameters:        - name: taskId          in: path          required: true          schema:            type: string      responses:        '200':          description: \u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0430\u0439\u0434\u0435\u043d\u0430          content:            application\/json:              schema:                $ref: '#\/components\/schemas\/Task'        '404':          description: \u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u0430components:  schemas:    Task:      type: object      required: [id, title, done]      properties:        id:          type: string        title:          type: string        done:          type: boolean<\/code>
<\/a><\/div><\/pre>\n
\u042d\u0442\u043e \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044f \u043f\u0440\u0430\u043a\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0431\u0435\u0437 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0438: \u0435\u0441\u0442\u044c \u043f\u0443\u0442\u044c\u00a0\/tasks\/{taskId}<\/code>, \u043e\u043d \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0432 \u043f\u0443\u0442\u0438, \u043e\u0442\u0434\u0430\u0451\u0442 \u043b\u0438\u0431\u043e\u00a0200<\/code>\u00a0\u0441 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c\u00a0Task<\/code>, \u043b\u0438\u0431\u043e\u00a0404<\/code>. \u0418 \u2014 \u043a\u043b\u044e\u0447\u0435\u0432\u043e\u0439 \u043c\u043e\u043c\u0435\u043d\u0442 \u2014 \u044d\u0442\u043e\u0442 \u0436\u0435 \u0441\u0430\u043c\u044b\u0439 \u0442\u0435\u043a\u0441\u0442 \u0447\u0438\u0442\u0430\u044e\u0442 \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a, \u0438 \u043c\u0430\u0448\u0438\u043d\u0430: \u0442\u043e, \u0447\u0442\u043e \u0432\u044b \u0441\u0435\u0439\u0447\u0430\u0441 \u0440\u0430\u0437\u043e\u0431\u0440\u0430\u043b\u0438 \u0433\u043b\u0430\u0437\u0430\u043c\u0438 \u0431\u0435\u0437 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0438, \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0435\u0442 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u043d\u043e. \u041e\u0434\u0438\u043d \u0444\u0430\u0439\u043b, \u043e\u0434\u043d\u0430 \u043f\u0440\u0430\u0432\u0434\u0430 \u2014 \u0438 \u0434\u043b\u044f \u043b\u044e\u0434\u0435\u0439, \u0438 \u0434\u043b\u044f \u043a\u043e\u0434\u0430.<\/p>\n
\u041f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u0432\u043c\u0435\u0441\u0442\u043e \u043a\u043e\u043f\u0438\u043f\u0430\u0441\u0442\u044b: DRY \u0432 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0438 API<\/h4>\n
\u041f\u0440\u0435\u0436\u0434\u0435 \u0447\u0435\u043c \u0438\u0434\u0442\u0438 \u0434\u0430\u043b\u044c\u0448\u0435, \u0441\u0442\u043e\u0438\u0442 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u0432 \u0440\u0443\u0447\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043f\u043e\u0447\u0442\u0438 \u043d\u0435\u0434\u043e\u0441\u0442\u0438\u0436\u0438\u043c\u043e, \u0430 \u0432 OpenAPI \u0434\u0430\u0451\u0442\u0441\u044f \u0434\u0430\u0440\u043e\u043c: \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435. \u042d\u0442\u043e, \u043d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u043e\u0434\u0438\u043d \u0438\u0437 \u0441\u0430\u043c\u044b\u0445 \u043d\u0435\u0434\u043e\u043e\u0446\u0435\u043d\u0451\u043d\u043d\u044b\u0445 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u043e\u0432, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043e\u0441\u0442\u0430\u043d\u043e\u0432\u043b\u044e\u0441\u044c \u043d\u0430 \u043d\u0451\u043c \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e.<\/p>\n
\u0421\u0445\u0435\u043c\u044b \u0434\u0430\u043d\u043d\u044b\u0445 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437.<\/strong>\u00a0\u0412 \u0432\u0438\u043a\u0438-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043e\u0434\u043d\u0430 \u0438 \u0442\u0430 \u0436\u0435 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 (\u0441\u043a\u0430\u0436\u0435\u043c, \u043e\u0431\u044a\u0435\u043a\u0442 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0438\u043b\u0438 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u0430\u044f \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0442\u0432\u0435\u0442\u0430) \u0440\u0430\u0441\u043f\u043e\u043b\u0437\u0430\u0435\u0442\u0441\u044f \u043f\u043e \u0434\u0435\u0441\u044f\u0442\u043a\u0430\u043c endpoints, \u0438 \u043a\u0430\u0436\u0434\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0436\u0438\u0432\u0451\u0442 \u0441\u0432\u043e\u0435\u0439 \u0436\u0438\u0437\u043d\u044c\u044e. \u041a\u0442\u043e-\u0442\u043e \u043f\u043e\u043f\u0440\u0430\u0432\u0438\u043b \u043f\u043e\u043b\u0435 \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u0438 \u0437\u0430\u0431\u044b\u043b \u0432 \u043f\u044f\u0442\u0438 \u0434\u0440\u0443\u0433\u0438\u0445 \u2014 \u0438 \u0432\u043e\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0443\u0436\u0435 \u043f\u0440\u043e\u0442\u0438\u0432\u043e\u0440\u0435\u0447\u0438\u0442 \u0441\u0430\u043c\u0430 \u0441\u0435\u0431\u0435. \u0412 OpenAPI \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0435\u0434\u0438\u043d\u043e\u0436\u0434\u044b \u0432\u00a0components\/schemas<\/code>, \u0430 \u0432\u0435\u0437\u0434\u0435 \u0434\u0430\u043b\u044c\u0448\u0435 \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437\u00a0$ref<\/code>. \u041f\u043e\u043f\u0440\u0430\u0432\u0438\u043b\u0438 \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u2014 \u0438\u0437\u043c\u0435\u043d\u0438\u043b\u043e\u0441\u044c \u0432\u0435\u0437\u0434\u0435. \u0420\u0430\u0441\u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u0438\u0435 \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u0430\u043c\u043e\u0433\u043e \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u043e \u043d\u0435\u0432\u043e\u0437\u043c\u043e\u0436\u043d\u044b\u043c.<\/p>\n
\u0420\u0430\u0437\u043d\u044b\u0435 \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u044b \u043e\u0442\u0432\u0435\u0442\u043e\u0432 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u043a\u0440\u0430\u0442\u043a\u043e \u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442 \u043e\u0431\u0449\u0435\u0435.<\/strong>\u00a0Endpoint \u0440\u0435\u0434\u043a\u043e \u043e\u0442\u0434\u0430\u0451\u0442 \u043e\u0434\u0438\u043d-\u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0432\u0438\u0434 \u043e\u0442\u0432\u0435\u0442\u0430: \u0435\u0441\u0442\u044c\u00a0200<\/code>, \u0435\u0441\u0442\u044c\u00a0400<\/code>,\u00a0404<\/code>,\u00a0409<\/code>, \u0438 \u0443 \u043e\u0448\u0438\u0431\u043e\u043a \u043e\u0431\u044b\u0447\u043d\u043e \u043e\u0431\u0449\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430. \u0412 \u0440\u0443\u0447\u043d\u043e\u043c \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0438 \u044d\u0442\u043e \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u043f\u043e\u0440\u0442\u044f\u043d\u043a\u0443, \u0433\u0434\u0435 \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0442\u0432\u0435\u0442\u0430 \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u043d\u0430 \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043a\u043e\u0434\u0430 \u0437\u0430\u043d\u043e\u0432\u043e. \u0412 OpenAPI \u0432\u0441\u0435 \u043e\u0448\u0438\u0431\u043e\u0447\u043d\u044b\u0435 \u043e\u0442\u0432\u0435\u0442\u044b \u0441\u0441\u044b\u043b\u0430\u044e\u0442\u0441\u044f \u043d\u0430 \u043e\u0434\u043d\u0443 \u0441\u0445\u0435\u043c\u0443, \u0430 \u0434\u043b\u044f \u00ab\u0432\u0441\u0435\u0445 \u043f\u0440\u043e\u0447\u0438\u0445 \u043a\u043e\u0434\u043e\u0432\u00bb \u0435\u0441\u0442\u044c\u00a0default<\/code>. \u041f\u043b\u044e\u0441 \u043d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435 \u0441\u0445\u0435\u043c \u0447\u0435\u0440\u0435\u0437\u00a0allOf<\/code>: \u043e\u0431\u0449\u0443\u044e \u0447\u0430\u0441\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u0440\u043e\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0445 \u0442\u0438\u043f\u043e\u0432 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442 \u043e\u0434\u0438\u043d \u0440\u0430\u0437, \u0430 \u0447\u0430\u0441\u0442\u043d\u044b\u0435 \u0441\u043b\u0443\u0447\u0430\u0438 \u0435\u0451 \u043d\u0430\u0441\u043b\u0435\u0434\u0443\u044e\u0442 \u2014 \u0442\u043e\u0442 \u0441\u0430\u043c\u044b\u0439 DRY \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0434\u0430\u043d\u043d\u044b\u0445. \u0412\u0430\u0436\u043d\u0430\u044f \u043e\u0433\u043e\u0432\u043e\u0440\u043a\u0430 \u043d\u0430 \u0431\u0443\u0434\u0443\u0449\u0435\u0435:\u00a0allOf<\/code>\u00a0\u2014 \u044d\u0442\u043e \u0438\u043c\u0435\u043d\u043d\u043e \u043d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435, \u0430 \u043d\u0435 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c, \u0438 \u044d\u0442\u043e \u0441\u043f\u043e\u043a\u043e\u0439\u043d\u044b\u0439, \u043f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u044b\u0439 \u0441\u043b\u0443\u0447\u0430\u0439 \u2014 \u043e\u043d \u0438 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u044d\u043b\u0435\u0433\u0430\u043d\u0442\u043d\u043e, \u0438 \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u0442\u0441\u044f \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430\u043c\u0438 \u0432 \u043a\u043e\u0434 \u0431\u0435\u0437 \u0441\u044e\u0440\u043f\u0440\u0438\u0437\u043e\u0432. \u0421 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u043d\u044b\u043c\u0438 union-\u0442\u0438\u043f\u0430\u043c\u0438 (oneOf<\/code>\/anyOf<\/code>) \u0434\u0435\u043b\u043e \u043e\u0431\u0441\u0442\u043e\u0438\u0442 \u0438\u043d\u0430\u0447\u0435, \u043d\u043e \u043e \u043d\u0438\u0445 \u0440\u0435\u0447\u044c \u043f\u043e\u0439\u0434\u0451\u0442 \u0432 \u0440\u0430\u0437\u0434\u0435\u043b\u0435 \u043f\u0440\u043e \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043a\u0438.<\/p>\n
\u041f\u0440\u0438\u043c\u0435\u0440\u044b \u0442\u043e\u0436\u0435 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442\u0441\u044f.<\/strong>\u00a0\u0425\u043e\u0440\u043e\u0448\u043e \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u043e\u0442\u0432\u0435\u0442\u0430 (examples<\/code>) \u043c\u043e\u0436\u043d\u043e \u0432\u044b\u043d\u0435\u0441\u0442\u0438 \u0432\u00a0components<\/code>\u00a0\u0438 \u0441\u0441\u044b\u043b\u0430\u0442\u044c\u0441\u044f \u043d\u0430 \u043d\u0435\u0433\u043e \u043e\u0442\u043e\u0432\u0441\u044e\u0434\u0443, \u0433\u0434\u0435 \u043e\u043d \u0443\u043c\u0435\u0441\u0442\u0435\u043d \u2014 \u0438\u0437 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u0438\u0437 mock-\u0441\u0435\u0440\u0432\u0435\u0440\u0430, \u0438\u0437 \u0442\u0435\u0441\u0442\u043e\u0432. \u041e\u0434\u0438\u043d \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u044b\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0441\u0440\u0430\u0437\u0443 \u043d\u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u0435\u0439, \u0430 \u043d\u0435 \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 \u043a\u0430\u0436\u0434\u043e\u043c.<\/p>\n
\u041f\u043e\u0441\u043c\u043e\u0442\u0440\u0438\u0442\u0435, \u043a\u0430\u043a \u043a\u043e\u043c\u043f\u0430\u043a\u0442\u043d\u043e \u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043d\u0430 \u043f\u0440\u0430\u043a\u0442\u0438\u043a\u0435:<\/p>\n
yaml<\/p>\n
paths:  \/tasks\/{taskId}:    get:      operationId: getTask      parameters:        - $ref: '#\/components\/parameters\/TaskId'   # \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u043e\u043f\u0438\u0441\u0430\u043d \u043e\u0434\u0438\u043d \u0440\u0430\u0437      responses:        '200':          description: \u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0430\u0439\u0434\u0435\u043d\u0430          content:            application\/json:              schema:                $ref: '#\/components\/schemas\/Task'              examples:                sample:                  $ref: '#\/components\/examples\/TaskSample'  # \u043f\u0440\u0438\u043c\u0435\u0440 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f        '404':          $ref: '#\/components\/responses\/NotFound'   # \u043e\u0431\u0449\u0438\u0439 \u043e\u0442\u0432\u0435\u0442 \u043e\u0431 \u043e\u0448\u0438\u0431\u043a\u0435        default:          $ref: '#\/components\/responses\/Error'       # \u0432\u0441\u0451 \u043f\u0440\u043e\u0447\u0435\u0435 \u2014 \u043e\u0434\u043d\u043e\u0439 \u0441\u0442\u0440\u043e\u043a\u043e\u0439components:  parameters:    TaskId:      name: taskId      in: path      required: true      schema:        type: string  responses:    NotFound:      description: \u041d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u043e      content:        application\/json:          schema:            $ref: '#\/components\/schemas\/Error'   # \u0442\u0430 \u0436\u0435 \u0441\u0445\u0435\u043c\u0430 \u043e\u0448\u0438\u0431\u043a\u0438    Error:      description: \u041e\u0448\u0438\u0431\u043a\u0430      content:        application\/json:          schema:            $ref: '#\/components\/schemas\/Error'  schemas:    Error:                       # \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0448\u0438\u0431\u043a\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0430 \u0440\u043e\u0432\u043d\u043e \u043e\u0434\u0438\u043d \u0440\u0430\u0437      type: object      required: [code, message]      properties:        code:          type: integer        message:          type: string    Task:      allOf:                     # \u043d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435: \u043e\u0431\u0449\u0435\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u043e\u0434\u0438\u043d \u0440\u0430\u0437        - $ref: '#\/components\/schemas\/Entity'        - type: object          required: [title, done]          properties:            title:              type: string            done:              type: boolean    Entity:                      # \u0431\u0430\u0437\u043e\u0432\u044b\u0435 \u043f\u043e\u043b\u044f, \u043e\u0431\u0449\u0438\u0435 \u0434\u043b\u044f \u043c\u043d\u043e\u0433\u0438\u0445 \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u0435\u0439      type: object      required: [id]      properties:        id:          type: string  examples:    TaskSample:      value:        id: \"42\"        title: \"\u041a\u0443\u043f\u0438\u0442\u044c \u043c\u043e\u043b\u043e\u043a\u043e\"        done: false<\/code>
<\/a><\/div><\/pre>\n
\u0417\u0434\u0435\u0441\u044c \u043d\u0435\u0442 \u043d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0433\u043e \u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u0430: \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440, \u0441\u0445\u0435\u043c\u0430 \u043e\u0448\u0438\u0431\u043a\u0438, \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0442\u0432\u0435\u0442\u0430, \u0431\u0430\u0437\u043e\u0432\u044b\u0435 \u043f\u043e\u043b\u044f \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u0438 \u0438 \u043f\u0440\u0438\u043c\u0435\u0440 \u2014 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u0432 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u043c \u044d\u043a\u0437\u0435\u043c\u043f\u043b\u044f\u0440\u0435, \u0430 endpoints \u043d\u0430 \u043d\u0438\u0445 \u0441\u0441\u044b\u043b\u0430\u044e\u0442\u0441\u044f. \u0412 \u0440\u0443\u0447\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0440\u043e\u0432\u043d\u043e \u044d\u0442\u0438 \u0432\u0435\u0449\u0438 \u043a\u043e\u043f\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u0441\u043d\u043e\u0432\u0430 \u0438 \u0441\u043d\u043e\u0432\u0430 \u0438 \u0438\u043c\u0435\u043d\u043d\u043e \u0432 \u044d\u0442\u043e\u043c \u043a\u043e\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0438 \u0438 \u043d\u0430\u043a\u0430\u043f\u043b\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0440\u0430\u0441\u0441\u0438\u043d\u0445\u0440\u043e\u043d.<\/p>\n
\u0418 \u0435\u0449\u0451 \u043e\u0434\u043d\u043e \u2014 \u043d\u0430 \u0441\u043b\u0443\u0447\u0430\u0439 \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0451\u043d\u043d\u043e\u0433\u043e \u043f\u0440\u0435\u0434\u0443\u0431\u0435\u0436\u0434\u0435\u043d\u0438\u044f, \u0447\u0442\u043e \u00abREST \u2014 \u044d\u0442\u043e \u043f\u0440\u043e \u0441\u0442\u0430\u0440\u043e\u043c\u043e\u0434\u043d\u044b\u0435 \u00ab\u0437\u0430\u043f\u0440\u043e\u0441-\u043e\u0442\u0432\u0435\u0442\u00bb, \u0430 \u0432\u0441\u0451 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0435 \u043c\u0438\u043c\u043e\u201c\u00bb. \u042d\u0442\u043e \u043d\u0435 \u0442\u0430\u043a. \u0421\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 OpenAPI \u0443\u043c\u0435\u044e\u0442 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0438 \u043f\u043e\u0442\u043e\u043a\u043e\u0432\u044b\u0435 (streaming) \u043e\u0442\u0432\u0435\u0442\u044b \u2014 \u0442\u0435 \u0441\u0430\u043c\u044b\u0435, \u043f\u043e \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u043e\u0442\u0432\u0435\u0442 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u043d\u0435 \u043e\u0434\u043d\u0438\u043c \u043a\u0443\u0441\u043a\u043e\u043c, \u0430 \u043f\u043e\u0441\u0442\u0435\u043f\u0435\u043d\u043d\u043e, \u043f\u043e \u043c\u0435\u0440\u0435 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438. \u0421\u0430\u043c\u044b\u0439 \u0443\u0437\u043d\u0430\u0432\u0430\u0435\u043c\u044b\u0439 \u0441\u0435\u0433\u043e\u0434\u043d\u044f \u043f\u0440\u0438\u043c\u0435\u0440 \u2014 \u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u0441 AI-\u0447\u0430\u0442-\u0431\u043e\u0442\u0430\u043c\u0438, \u0433\u0434\u0435 \u0442\u0435\u043a\u0441\u0442 \u00ab\u043f\u0435\u0447\u0430\u0442\u0430\u0435\u0442\u0441\u044f\u00bb \u043d\u0430 \u044d\u043a\u0440\u0430\u043d\u0435 \u043f\u043e \u043c\u0435\u0440\u0435 \u043f\u043e\u0441\u0442\u0443\u043f\u043b\u0435\u043d\u0438\u044f \u0442\u043e\u043a\u0435\u043d\u043e\u0432 (\u043a\u0430\u043a \u043f\u0440\u0430\u0432\u0438\u043b\u043e, \u0447\u0435\u0440\u0435\u0437 Server-Sent Events). \u0422\u0430\u043a\u0438\u0435 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b OpenAPI \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u043d\u0430\u0440\u0430\u0432\u043d\u0435 \u0441 \u043e\u0431\u044b\u0447\u043d\u044b\u043c\u0438, \u0430 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b \u0438\u0445 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442: \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0439 swift-openapi-generator \u0443\u043c\u0435\u0435\u0442 \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c \u0442\u0435\u043b\u043e \u043f\u043e\u0442\u043e\u043a\u043e\u0432\u043e\u0433\u043e \u043e\u0442\u0432\u0435\u0442\u0430 \u043a\u0430\u043a\u00a0AsyncSequence<\/code>\u00a0\u2014 \u0442\u043e \u0435\u0441\u0442\u044c \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442 \u0432\u044b\u0434\u0430\u0451\u0442 \u043f\u043e\u0442\u043e\u043a, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 Swift \u043e\u0431\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0440\u043e\u0434\u043d\u044b\u043c\u00a0for try await<\/code>. \u0422\u0430\u043a \u0447\u0442\u043e \u043f\u043e\u0434\u0445\u043e\u0434 \u00ab\u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u00bb \u043d\u0435 \u0437\u0430\u043f\u0438\u0440\u0430\u0435\u0442 \u0432\u0430\u0441 \u0432 \u043f\u0430\u0440\u0430\u0434\u0438\u0433\u043c\u0435 \u043f\u0440\u043e\u0448\u043b\u043e\u0433\u043e \u0434\u0435\u0441\u044f\u0442\u0438\u043b\u0435\u0442\u0438\u044f: \u043e\u043d \u043f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0438 \u0442\u043e, \u0447\u0442\u043e \u0432\u044b \u043f\u0438\u0448\u0435\u0442\u0435 \u043f\u0440\u044f\u043c\u043e \u0441\u0435\u0439\u0447\u0430\u0441, \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u0443\u044f \u043e\u0447\u0435\u0440\u0435\u0434\u043d\u0443\u044e LLM.<\/p>\n\n
\u0418\u0434\u0435\u044f \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0433\u043e \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u043f\u0440\u0430\u0432\u0434\u044b<\/h3>\n
\u0412\u0435\u0441\u044c \u0441\u043c\u044b\u0441\u043b \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u0432 \u043e\u0434\u043d\u043e\u0439 \u0444\u0440\u0430\u0437\u0435: \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u0451\u0442 \u0431\u044b\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u0438 \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u043c. \u0421 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u043c \u043e\u0431\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u0442\u0430\u043a \u0436\u0435 \u0441\u0442\u0440\u043e\u0433\u043e, \u043a\u0430\u043a \u0441 \u043a\u043e\u0434\u043e\u043c: \u043e\u043d \u043b\u0435\u0436\u0438\u0442 \u0432 \u0441\u0438\u0441\u0442\u0435\u043c\u0435 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u044f \u0432\u0435\u0440\u0441\u0438\u0439, \u043a \u043d\u0435\u043c\u0443 \u043f\u0438\u0448\u0443\u0442 pull request’\u044b, \u0435\u0433\u043e \u0440\u0435\u0432\u044c\u044e\u044f\u0442, \u0435\u0433\u043e \u0432\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u0443\u044e\u0442 \u043f\u043e SemVer. \u041b\u044e\u0431\u043e\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435 API \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0441 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0430 \u043d\u0435 \u0441 \u043f\u0440\u0430\u0432\u043a\u0438 \u043a\u043e\u0434\u0430 \u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0433\u043e \u00ab\u043d\u0435 \u0437\u0430\u0431\u044b\u0442\u044c \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u044c \u0432\u0438\u043a\u0438\u00bb.<\/p>\n
\u0412 \u0440\u0443\u0441\u0441\u043a\u043e\u044f\u0437\u044b\u0447\u043d\u044b\u0445 \u043a\u0435\u0439\u0441\u0430\u0445 \u044d\u0442\u043e \u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u0443\u044e\u0442 \u043f\u043e-\u0440\u0430\u0437\u043d\u043e\u043c\u0443 \u2014 Contract-First, Design-First, Specification-First, Manifest-First, \u2014 \u043d\u043e \u0441\u0443\u0442\u044c \u043e\u0434\u043d\u0430: \u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442, \u043f\u043e\u0442\u043e\u043c \u043a\u043e\u0434. \u0418 \u0442\u0443\u0442 \u0432\u0430\u0436\u043d\u043e \u0441\u0440\u0430\u0437\u0443 \u0441\u043d\u044f\u0442\u044c \u043e\u0434\u043d\u043e \u043d\u0435\u0434\u043e\u0440\u0430\u0437\u0443\u043c\u0435\u043d\u0438\u0435. \u0421\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u0438 \u043e\u0431\u0440\u0430\u0442\u043d\u044b\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u2014 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u0438\u0437 \u043a\u043e\u0434\u0430 (code-first, \u0447\u0435\u0440\u0435\u0437 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0438). \u041e\u043d \u043a\u0430\u0436\u0435\u0442\u0441\u044f \u0434\u0435\u0448\u0435\u0432\u043b\u0435, \u043d\u043e \u0432\u043e\u0441\u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442 \u0440\u043e\u0432\u043d\u043e \u0442\u0443 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0443, \u0441 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043c\u044b \u043d\u0430\u0447\u0430\u043b\u0438: \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0432\u0442\u043e\u0440\u0438\u0447\u043d\u044b\u043c, \u043f\u043e\u0431\u043e\u0447\u043d\u044b\u043c \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u043e\u043c, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043e\u0442\u0441\u0442\u0430\u0451\u0442 \u043e\u0442 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u0438. \u041c\u0430\u0442\u0432\u0435\u0439 \u041b\u0438\u0445\u043e\u0442\u0430 \u0438\u0437 \u041c\u0422\u0421 Web Services \u0432 \u0441\u0432\u043e\u0451\u043c \u0440\u0430\u0437\u0431\u043e\u0440\u0435<\/a> \u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u0443\u0435\u0442 \u044d\u0442\u043e \u0442\u0430\u043a: \u00ab\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043f\u0438\u0448\u0443\u0442 \u0440\u0443\u043a\u0430\u043c\u0438 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043e\u0442 \u043a\u043e\u0434\u0430, \u0443\u0441\u0442\u0430\u0440\u0435\u0432\u0430\u0435\u0442 \u0443\u0436\u0435 \u0432 \u043c\u043e\u043c\u0435\u043d\u0442 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0433\u043e \u043a\u043e\u043c\u043c\u0438\u0442\u0430\u00bb \u2014 \u0438 \u0438\u043c\u0435\u043d\u043d\u043e \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0435\u0433\u043e \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u0440\u0430\u0437\u0432\u0435\u0440\u043d\u0443\u043b\u0430 \u043f\u0440\u043e\u0446\u0435\u0441\u0441 \u0438 \u0441\u0434\u0435\u043b\u0430\u043b\u0430 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u043f\u0435\u0440\u0432\u0438\u0447\u043d\u043e\u0439.<\/p>\n
\u041a\u043e\u0433\u0434\u0430 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u043f\u0435\u0440\u0432\u0438\u0447\u0435\u043d, \u0443 \u043d\u0435\u0433\u043e \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e, \u043a\u043e\u0442\u043e\u0440\u043e\u0433\u043e \u043d\u0435\u0442 \u043d\u0438 \u0443 \u0432\u0438\u043a\u0438, \u043d\u0438 \u0443 \u0433\u043e\u043b\u043e\u0432\u044b \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440\u0430: \u043e\u043d \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439, \u0438 \u0432\u0445\u043e\u0434\u043d\u044b\u043c\u0438 \u0434\u0430\u043d\u043d\u044b\u043c\u0438 \u0434\u043b\u044f \u0446\u0435\u043b\u043e\u0433\u043e \u0437\u043e\u043e\u043f\u0430\u0440\u043a\u0430 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432. \u0418 \u0432\u043e\u0442 \u0442\u0443\u0442 \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0441\u0430\u043c\u043e\u0435 \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e\u0435.<\/p>\n
\u041a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f: \u043f\u043e\u043b\u0435\u0437\u043d\u043e, \u043d\u043e \u044d\u0442\u043e \u043d\u0435 \u0433\u043b\u0430\u0432\u043d\u043e\u0435<\/h3>\n
\u041f\u0435\u0440\u0432\u043e\u0435, \u043e \u0447\u0451\u043c \u0432\u0441\u043f\u043e\u043c\u0438\u043d\u0430\u044e\u0442 \u043f\u0440\u0438 \u0441\u043b\u043e\u0432\u0435 OpenAPI, \u2014 \u044d\u0442\u043e \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f: \u0438\u0437 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043c\u043e\u0436\u043d\u043e \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0439 \u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u043d\u044b\u0439 \u043a\u043e\u0434. \u0414\u043b\u044f \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u043e\u0433\u043e \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u044d\u0442\u043e \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442, \u0447\u0442\u043e \u043d\u0435 \u043d\u0443\u0436\u043d\u043e \u0440\u0443\u043a\u0430\u043c\u0438 \u043f\u0438\u0441\u0430\u0442\u044c \u043c\u043e\u0434\u0435\u043b\u0438 \u0434\u0430\u043d\u043d\u044b\u0445, \u043f\u0430\u0440\u0441\u0438\u043d\u0433, \u0441\u0435\u0442\u0435\u0432\u043e\u0439 \u0441\u043b\u043e\u0439 \u2014 \u0432\u0441\u0451 \u044d\u0442\u043e \u0431\u0435\u0440\u0451\u0442\u0441\u044f \u0438\u0437 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u0438 \u0432\u0441\u0435\u0433\u0434\u0430 \u0435\u043c\u0443 \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u0435\u0442.<\/p>\n
\u041f\u043e\u0441\u043a\u043e\u043b\u044c\u043a\u0443 \u044f \u043f\u0438\u0448\u0443 \u043f\u043e\u0434 Apple-\u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u044b, \u043c\u043d\u0435 \u0431\u043b\u0438\u0436\u0435 \u0432\u0441\u0435\u0433\u043e \u0438\u0441\u0442\u043e\u0440\u0438\u044f \u0441\u043e Swift. \u0423 Apple \u0435\u0441\u0442\u044c \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0439 swift-openapi-generator<\/a> \u2014 \u044d\u0442\u043e \u043f\u043b\u0430\u0433\u0438\u043d \u0434\u043b\u044f \u043f\u0430\u043a\u0435\u0442\u043d\u043e\u0433\u043e \u043c\u0435\u043d\u0435\u0434\u0436\u0435\u0440\u0430, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u043a\u043e\u0434 \u043f\u0440\u044f\u043c\u043e \u043d\u0430 \u044d\u0442\u0430\u043f\u0435 \u0441\u0431\u043e\u0440\u043a\u0438. \u042d\u0442\u043e \u0432\u0430\u0436\u043d\u0430\u044f \u0434\u0435\u0442\u0430\u043b\u044c: \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043a\u043e\u0434 \u043d\u0435 \u043d\u0443\u0436\u043d\u043e \u043a\u043e\u043c\u043c\u0438\u0442\u0438\u0442\u044c \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u043e\u043d \u0432\u0441\u0435\u0433\u0434\u0430 \u043f\u0435\u0440\u0435\u0441\u043e\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0438\u0437 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u0439 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0430 \u0437\u043d\u0430\u0447\u0438\u0442 \u0444\u0438\u0437\u0438\u0447\u0435\u0441\u043a\u0438 \u043d\u0435 \u043c\u043e\u0436\u0435\u0442 \u00ab\u0440\u0430\u0437\u044a\u0435\u0445\u0430\u0442\u044c\u0441\u044f\u00bb \u0441 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u043c. \u0412\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0432\u044b\u0437\u043e\u0432 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0430 \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e \u0442\u0430\u043a:<\/p>\n
let client = Client(    serverURL: URL(string: \"https:\/\/api.example.com\")!,    transport: URLSessionTransport())let response = try await client.getTask(path: .init(taskId: \"42\"))switch response {case .ok(let ok):    let task = try ok.body.json    print(task.title)case .notFound:    print(\"\u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u0430\")}<\/code>
<\/a><\/div><\/pre>\n
\u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: \u0438 \u043c\u0435\u0442\u043e\u0434\u00a0getTask<\/code>, \u0438 \u0440\u0430\u0437\u0431\u043e\u0440 \u043e\u0442\u0432\u0435\u0442\u0430 \u043d\u0430 \u0441\u043b\u0443\u0447\u0430\u0438\u00a0.ok<\/code>\u00a0\/\u00a0.notFound<\/code>\u00a0\u2014 \u044d\u0442\u043e \u043d\u0435 \u0442\u043e, \u0447\u0442\u043e \u044f \u043f\u0438\u0441\u0430\u043b \u0440\u0443\u043a\u0430\u043c\u0438, \u044d\u0442\u043e \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043e \u0438\u0437 \u0442\u043e\u0439 \u0441\u0430\u043c\u043e\u0439 YAML-\u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0432\u044b\u0448\u0435. \u041a\u043e\u043c\u043f\u0438\u043b\u044f\u0442\u043e\u0440 \u0442\u0435\u043f\u0435\u0440\u044c \u043d\u0430 \u043c\u043e\u0435\u0439 \u0441\u0442\u043e\u0440\u043e\u043d\u0435: \u0435\u0441\u043b\u0438 \u0431\u044d\u043a\u0435\u043d\u0434 \u0438\u0437\u043c\u0435\u043d\u0438\u0442 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442, \u0443 \u043c\u0435\u043d\u044f \u043f\u0440\u043e\u0441\u0442\u043e \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u043d\u0435\u0442 \u0441\u043e\u0431\u0438\u0440\u0430\u0442\u044c\u0441\u044f \u043a\u043e\u0434 \u0432 \u043d\u0443\u0436\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435, \u0430 \u043d\u0435 \u00ab\u0443\u043f\u0430\u0434\u0451\u0442 \u0432 \u0440\u0430\u043d\u0442\u0430\u0439\u043c\u0435 \u0443 \u0447\u0430\u0441\u0442\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439\u00bb.<\/p>\n
\u041a\u0440\u043e\u043c\u0435 \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430 \u0432 Swift-\u044d\u043a\u043e\u0441\u0438\u0441\u0442\u0435\u043c\u0435 \u0435\u0441\u0442\u044c \u0438 \u0441\u0442\u043e\u0440\u043e\u043d\u043d\u0438\u0435 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043f\u0440\u043e\u0435\u043a\u0442\u044b, \u043e\u043f\u0442\u0438\u043c\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043f\u043e\u0434 \u043b\u0451\u0433\u043a\u0438\u0439 \u0441\u0435\u0442\u0435\u0432\u043e\u0439 \u043a\u043b\u0438\u0435\u043d\u0442. \u041f\u043e\u0434 Kotlin\/Android \u0438 \u0434\u0435\u0441\u043a\u0442\u043e\u043f \u0435\u0441\u0442\u044c \u0441\u0432\u043e\u0438 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u044b, \u0430 \u0443 Microsoft \u2014 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u043a\u0440\u043e\u0441\u0441-\u044f\u0437\u044b\u043a\u043e\u0432\u043e\u0439 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 Kiota, \u043f\u043b\u044e\u0441 \u0435\u0441\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b, \u0437\u0430\u0442\u043e\u0447\u0435\u043d\u043d\u044b\u0435 \u043f\u043e\u0434 .NET (NSwag). \u0422\u043e \u0435\u0441\u0442\u044c \u0438\u0437 \u043e\u0434\u043d\u043e\u0433\u043e \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u043c\u043e\u0436\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432 \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0434 \u0432\u0441\u0435 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u044b \u2014 \u0440\u043e\u0432\u043d\u043e \u043e\u0431 \u044d\u0442\u043e\u043c \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b\u0432\u0430\u044e\u0442 \u0432 \u043a\u0435\u0439\u0441\u0430\u0445 \u042eMoney, \u0433\u0434\u0435 \u0438\u0437 \u043e\u0434\u043d\u043e\u0439 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043f\u043e\u043b\u0443\u0447\u0430\u044e\u0442 \u043a\u043e\u0434 \u0438 \u0434\u043b\u044f iOS, \u0438 \u0434\u043b\u044f Android.<\/p>\n
\u041d\u043e \u0432\u043e\u0442 \u0447\u0442\u043e \u044f \u0445\u043e\u0447\u0443 \u043f\u043e\u0434\u0447\u0435\u0440\u043a\u043d\u0443\u0442\u044c, \u0438 \u044d\u0442\u043e, \u043d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u0433\u043b\u0430\u0432\u043d\u0430\u044f \u043c\u044b\u0441\u043b\u044c \u0441\u0442\u0430\u0442\u044c\u0438: \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u2014 \u044d\u0442\u043e \u043f\u0440\u0438\u044f\u0442\u043d\u044b\u0439 \u0431\u043e\u043d\u0443\u0441, \u0430 \u043d\u0435 \u043f\u0440\u0438\u0447\u0438\u043d\u0430 \u0432\u043d\u0435\u0434\u0440\u044f\u0442\u044c OpenAPI. \u0423 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430 \u0435\u0441\u0442\u044c \u0441\u0432\u043e\u044f \u0446\u0435\u043d\u0430 (\u043e\u0431 \u044d\u0442\u043e\u043c \u043d\u0438\u0436\u0435), \u0438 \u0435\u0441\u043b\u0438 \u0431\u044b \u0432\u0441\u0451 \u0441\u0432\u043e\u0434\u0438\u043b\u043e\u0441\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u043a \u043d\u0435\u0439, \u0441\u043f\u043e\u0440\u0438\u0442\u044c \u043e \u043f\u043e\u0434\u0445\u043e\u0434\u0435 \u0431\u044b\u043b\u043e \u0431\u044b \u043a\u0443\u0434\u0430 \u0441\u043b\u043e\u0436\u043d\u0435\u0435. \u041d\u0430\u0441\u0442\u043e\u044f\u0449\u0430\u044f \u0446\u0435\u043d\u043d\u043e\u0441\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u2014 \u0432 \u0442\u043e\u043c, \u0447\u0442\u043e \u043e\u043d \u0432\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u0446\u0435\u043b\u0443\u044e \u044d\u043a\u043e\u0441\u0438\u0441\u0442\u0435\u043c\u0443 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442, \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u0432\u044b \u043d\u0435 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0435 \u043d\u0438 \u0441\u0442\u0440\u043e\u0447\u043a\u0438 \u043a\u043e\u0434\u0430.<\/p>\n
\u0413\u043b\u0430\u0432\u043d\u044b\u0439 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442: \u0432\u044b\u0433\u043e\u0434\u044b, \u043d\u0435 \u0441\u0432\u044f\u0437\u0430\u043d\u043d\u044b\u0435 \u0441 \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439<\/h3>\n
\u0412\u043e\u0442 \u0437\u0434\u0435\u0441\u044c, \u043d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u0438 \u043b\u0435\u0436\u0438\u0442 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0438\u0439 \u043e\u0442\u0432\u0435\u0442 \u043d\u0430 \u0432\u043e\u043f\u0440\u043e\u0441 \u00ab\u0437\u0430\u0447\u0435\u043c \u043d\u0430\u043c \u044d\u0442\u043e\u00bb. \u041f\u0435\u0440\u0435\u0447\u0438\u0441\u043b\u044e \u043f\u043e \u043f\u043e\u0440\u044f\u0434\u043a\u0443.<\/p>\n
\u041b\u0438\u043d\u0442\u0438\u043d\u0433 \u0438 \u0435\u0434\u0438\u043d\u044b\u0439 \u0441\u0442\u0438\u043b\u044c API.<\/strong>\u00a0\u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u043c\u043e\u0436\u043d\u043e \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u043b\u0438\u043d\u0442\u0435\u0440\u043e\u043c \u2014 \u0441\u0430\u043c\u044b\u0439 \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u0437\u0434\u0435\u0441\u044c Spectral, \u0435\u0441\u0442\u044c \u0438 \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u044b \u0432\u0440\u043e\u0434\u0435 Redocly CLI \u0438 Vacuum. \u041b\u0438\u043d\u0442\u0435\u0440 \u0441\u043b\u0435\u0434\u0438\u0442, \u0447\u0442\u043e\u0431\u044b \u0432\u0441\u0435 endpoints \u0431\u044b\u043b\u0438 \u0432 \u043e\u0434\u043d\u043e\u043c \u0441\u0442\u0438\u043b\u0435, \u0447\u0442\u043e\u0431\u044b \u0443 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439 \u0431\u044b\u043b\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u0438 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u044b, \u0447\u0442\u043e\u0431\u044b \u0441\u043e\u0431\u043b\u044e\u0434\u0430\u043b\u0438\u0441\u044c \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u043a\u043e\u043d\u0432\u0435\u043d\u0446\u0438\u0438 \u0438 \u043f\u0440\u0430\u0432\u0438\u043b\u0430 \u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u0438. \u042d\u0442\u043e \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0430\u0431\u0441\u0442\u0440\u0430\u043a\u0442\u043d\u044b\u0439 \u00ab\u0433\u0430\u0439\u0434 \u043f\u043e \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u044e API\u00bb \u0432 \u0438\u0441\u043f\u043e\u043b\u043d\u044f\u0435\u043c\u043e\u0435 \u043f\u0440\u0430\u0432\u0438\u043b\u043e, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u0441\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u0442 \u0432 CI, \u0430 \u043d\u0435 \u0436\u0438\u0432\u0451\u0442 \u0432 \u0437\u0430\u0431\u044b\u0442\u043e\u0439 \u0432\u0438\u043a\u0438-\u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435.<\/p>\n
Mock-\u0441\u0435\u0440\u0432\u0435\u0440 \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438.<\/strong>\u00a0\u041f\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043c\u043e\u0436\u043d\u043e \u043f\u043e\u0434\u043d\u044f\u0442\u044c mock-\u0441\u0435\u0440\u0432\u0435\u0440 \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0447\u0435\u0440\u0435\u0437 Prism. \u042d\u0442\u043e \u0437\u043d\u0430\u0447\u0438\u0442, \u0447\u0442\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u043c\u043e\u0436\u0435\u0442 \u043d\u0430\u0447\u0430\u0442\u044c \u0440\u0430\u0431\u043e\u0442\u0443 \u0434\u043e \u0442\u043e\u0433\u043e, \u043a\u0430\u043a \u0431\u044d\u043a\u0435\u043d\u0434 \u043d\u0430\u043f\u0438\u0448\u0435\u0442 \u0445\u043e\u0442\u044c \u0441\u0442\u0440\u043e\u0447\u043a\u0443 \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0438: mock \u043e\u0442\u0434\u0430\u0451\u0442 \u043e\u0442\u0432\u0435\u0442\u044b, \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0443. \u0424\u0440\u043e\u043d\u0442\u0435\u043d\u0434 \u0438 \u0431\u044d\u043a\u0435\u043d\u0434 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e, \u0430 \u043d\u0435 \u043f\u043e \u043e\u0447\u0435\u0440\u0435\u0434\u0438. \u0414\u043b\u044f \u043c\u0435\u043d\u044f \u043a\u0430\u043a \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u043e\u0433\u043e \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430 \u044d\u0442\u043e, \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e, \u0441\u0430\u043c\u044b\u0439 \u043d\u0435\u0434\u043e\u043e\u0446\u0435\u043d\u0451\u043d\u043d\u044b\u0439 \u043f\u0443\u043d\u043a\u0442: \u044f \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u044e \u0431\u044b\u0442\u044c \u0432 \u0445\u0432\u043e\u0441\u0442\u0435 \u043e\u0447\u0435\u0440\u0435\u0434\u0438.<\/p>\n
\u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043d\u043e\u0435 \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435.<\/strong>\u00a0\u0422\u043e\u0442 \u0436\u0435 Prism \u0443\u043c\u0435\u0435\u0442 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0432 \u0440\u0435\u0436\u0438\u043c\u0435 \u043f\u0440\u043e\u043a\u0441\u0438: \u043e\u043d \u043f\u0440\u043e\u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u0442\u0440\u0430\u0444\u0438\u043a \u0447\u0435\u0440\u0435\u0437 \u0441\u0435\u0431\u044f \u0438 \u0441\u0432\u0435\u0440\u044f\u0435\u0442 \u0438 \u0437\u0430\u043f\u0440\u043e\u0441\u044b, \u0438 \u043e\u0442\u0432\u0435\u0442\u044b \u0441 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u043c, \u0441\u043e\u043e\u0431\u0449\u0430\u044f \u043e \u043b\u044e\u0431\u044b\u0445 \u0440\u0430\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u044f\u0445. \u042d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c \u0442\u0430 \u0441\u0430\u043c\u0430\u044f \u0437\u0430\u0449\u0438\u0442\u0430 \u043e\u0442 \u0434\u0440\u0435\u0439\u0444\u0430: \u0435\u0441\u043b\u0438 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u0435\u0440\u0432\u0435\u0440 \u043d\u0430\u0447\u0430\u043b \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c \u043d\u0435 \u0442\u043e, \u0447\u0442\u043e \u043e\u0431\u0435\u0449\u0430\u043d\u043e \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0432\u044b \u0443\u0437\u043d\u0430\u0451\u0442\u0435 \u043e\u0431 \u044d\u0442\u043e\u043c \u0432 \u0442\u0435\u0441\u0442\u0430\u0445, \u0430 \u043d\u0435 \u043e\u0442 \u0440\u0430\u0441\u0441\u0435\u0440\u0436\u0435\u043d\u043d\u044b\u0445 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439. \u0414\u043b\u044f \u0431\u043e\u043b\u0435\u0435 \u0433\u043b\u0443\u0431\u043e\u043a\u043e\u0433\u043e \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0435\u0441\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b, \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u044e\u0449\u0438\u0435 \u0442\u0435\u0441\u0442-\u043a\u0435\u0439\u0441\u044b \u043f\u0440\u044f\u043c\u043e \u0438\u0437 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, Schemathesis).<\/p>\n
\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043d\u0435 \u0432\u0440\u0451\u0442.<\/strong>\u00a0\u0418\u0437 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043a\u0440\u0430\u0441\u0438\u0432\u0430\u044f \u0438\u043d\u0442\u0435\u0440\u0430\u043a\u0442\u0438\u0432\u043d\u0430\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0447\u0435\u0440\u0435\u0437 Redoc\/Redocly \u0438\u043b\u0438 Swagger UI. \u041d\u043e \u0432 \u043e\u0442\u043b\u0438\u0447\u0438\u0435 \u043e\u0442 \u0432\u0438\u043a\u0438, \u044d\u0442\u0430 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043d\u0435 \u043c\u043e\u0436\u0435\u0442 \u0443\u0441\u0442\u0430\u0440\u0435\u0442\u044c: \u043e\u043d\u0430 \u043f\u043e\u0440\u043e\u0436\u0434\u0430\u0435\u0442\u0441\u044f \u0438\u0437 \u0442\u043e\u0433\u043e \u0436\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u043e\u043c \u043f\u0440\u0430\u0432\u0434\u044b. \u0420\u0430\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u0435 \u043c\u0435\u0436\u0434\u0443 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u0438 \u00ab\u043f\u0440\u0430\u0432\u0434\u043e\u0439\u00bb \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u043e \u043d\u0435\u0432\u043e\u0437\u043c\u043e\u0436\u043d\u044b\u043c.<\/p>\n
\u041e\u0431\u043d\u0430\u0440\u0443\u0436\u0435\u043d\u0438\u0435 breaking changes.<\/strong>\u00a0\u042d\u0442\u043e \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439, \u043e\u0447\u0435\u043d\u044c \u0432\u0430\u0436\u043d\u044b\u0439 \u0434\u043b\u044f \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044f API \u043f\u0443\u043d\u043a\u0442. \u0418\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 oasdiff \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0435\u0442 \u0434\u0432\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0438 \u0433\u043e\u0432\u043e\u0440\u0438\u0442, \u043a\u0430\u043a\u0438\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u043b\u043e\u043c\u0430\u044e\u0442 \u043e\u0431\u0440\u0430\u0442\u043d\u0443\u044e \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c, \u0430 \u043a\u0430\u043a\u0438\u0435 \u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u044b. \u0415\u0433\u043e \u043c\u043e\u0436\u043d\u043e \u0432\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0432 CI \u0438 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u0430\u0442\u044c pull request, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0435\u0437\u0430\u043c\u0435\u0442\u043d\u043e \u043b\u043e\u043c\u0430\u0435\u0442 \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432. \u0414\u043b\u044f \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u043e\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438, \u0433\u0434\u0435 \u0441\u0442\u0430\u0440\u044b\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u0436\u0438\u0432\u0443\u0442 \u043d\u0430 \u0443\u0441\u0442\u0440\u043e\u0439\u0441\u0442\u0432\u0430\u0445 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 \u043c\u0435\u0441\u044f\u0446\u0430\u043c\u0438, \u044d\u0442\u043e \u043a\u0440\u0438\u0442\u0438\u0447\u043d\u043e: breaking change \u0432 API \u2014 \u044d\u0442\u043e \u043d\u0435 \u0430\u0431\u0441\u0442\u0440\u0430\u043a\u0446\u0438\u044f, \u044d\u0442\u043e \u0443\u043f\u0430\u0432\u0448\u0435\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0443 \u0447\u0435\u043b\u043e\u0432\u0435\u043a\u0430, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0435 \u043e\u0431\u043d\u043e\u0432\u0438\u043b\u0441\u044f.<\/p>\n
\u0420\u0435\u0432\u0435\u0440\u0441-\u0438\u043d\u0436\u0438\u043d\u0438\u0440\u0438\u043d\u0433 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0445 API.<\/strong>\u00a0\u0410 \u0447\u0442\u043e, \u0435\u0441\u043b\u0438 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043d\u0435\u0442, \u0430 API \u0443\u0436\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442? \u0422\u043e\u0436\u0435 \u043d\u0435 \u0442\u0443\u043f\u0438\u043a. \u0415\u0441\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0441\u0442\u0440\u043e\u044f\u0442 \u0447\u0435\u0440\u043d\u043e\u0432\u0438\u043a OpenAPI \u0438\u0437 \u043d\u0430\u0431\u043b\u044e\u0434\u0430\u0435\u043c\u043e\u0433\u043e \u0442\u0440\u0430\u0444\u0438\u043a\u0430 \u2014 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f \u0434\u043b\u044f \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0441\u043b\u0443\u0448\u0430\u044e\u0442 \u0441\u0435\u0442\u0435\u0432\u044b\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u044b (openapi-devtools), \u0438 \u0443\u0442\u0438\u043b\u0438\u0442\u044b, \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u0443\u044e\u0449\u0438\u0435 \u043f\u0435\u0440\u0435\u0445\u0432\u0430\u0447\u0435\u043d\u043d\u044b\u0439 \u0442\u0440\u0430\u0444\u0438\u043a \u0438\u043b\u0438 \u043a\u043e\u043b\u043b\u0435\u043a\u0446\u0438\u0438 Postman \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e (mitmproxy2swagger, postman2openapi). \u042d\u0442\u043e \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u00ab\u0434\u043e\u0433\u043d\u0430\u0442\u044c\u00bb design-first \u0434\u0430\u0436\u0435 \u043d\u0430 \u043b\u0435\u0433\u0430\u0441\u0438.<\/p>\n
Overlays \u2014 \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u0430\u044f \u043c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u0431\u0435\u0437 \u043f\u0440\u0430\u0432\u043a\u0438 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b\u0430.<\/strong>\u00a0\u041e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442 OpenAPI Overlays \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043d\u0430\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0442\u044c \u043d\u0430 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f, \u043d\u0435 \u0442\u0440\u043e\u0433\u0430\u044f \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a: \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f, \u0441\u043a\u0440\u044b\u0442\u044c \u0432\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 endpoints \u043f\u0435\u0440\u0435\u0434 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0435\u0439 \u043d\u0430\u0440\u0443\u0436\u0443, \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0440\u0430\u0437\u043d\u044b\u0435 \u0441\u0435\u0440\u0432\u0435\u0440\u043d\u044b\u0435 URL \u0434\u043b\u044f \u0440\u0430\u0437\u043d\u044b\u0445 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u0439. \u042d\u0442\u043e \u0443\u0434\u043e\u0431\u043d\u043e, \u043a\u043e\u0433\u0434\u0430 \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u0439 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0438\u043b\u0438 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0434\u0440\u0443\u0433\u043e\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u043e\u0439.<\/p>\n
AI \u0438 MCP.<\/strong>\u00a0\u0421\u0432\u0435\u0436\u0438\u0439 \u043f\u043b\u0430\u0441\u0442: \u043f\u043e \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043c\u043e\u0436\u043d\u043e \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043f\u043e\u0434\u043d\u044f\u0442\u044c MCP-\u0441\u0435\u0440\u0432\u0435\u0440 (Model Context Protocol) \u2014 \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0447\u0435\u0440\u0435\u0437 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 emcee, \u2014 \u0438 \u0442\u043e\u0433\u0434\u0430 AI-\u0430\u0433\u0435\u043d\u0442 \u0441\u043c\u043e\u0436\u0435\u0442 \u0445\u043e\u0434\u0438\u0442\u044c \u0432 \u0432\u0430\u0448 API \u043a\u0430\u043a \u0432 \u043d\u0430\u0431\u043e\u0440 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0437\u0434\u0435\u0441\u044c \u0441\u043d\u043e\u0432\u0430 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043a\u0430\u043a \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b\u044c\u043d\u044b\u0439 \u0430\u0434\u0430\u043f\u0442\u0435\u0440: \u0442\u043e, \u0447\u0442\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u043e\u0434\u0438\u043d \u0440\u0430\u0437, \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0438 \u043b\u044e\u0434\u044c\u043c\u0438, \u0438 \u043c\u0430\u0448\u0438\u043d\u0430\u043c\u0438, \u0438 \u044f\u0437\u044b\u043a\u043e\u0432\u044b\u043c\u0438 \u043c\u043e\u0434\u0435\u043b\u044f\u043c\u0438.<\/p>\n
\u0420\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u044b \u0438 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b \u0434\u0438\u0437\u0430\u0439\u043d\u0430.<\/strong>\u00a0\u0420\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u043c \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e \u0441\u0442\u0430\u043b\u043e \u0443\u0434\u043e\u0431\u043d\u043e. \u0413\u043b\u0430\u0432\u043d\u044b\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u0437\u0434\u0435\u0441\u044c \u2014 \u043f\u043b\u0430\u0433\u0438\u043d OpenAPI (Swagger) Editor \u043e\u0442 42Crunch \u0434\u043b\u044f VS Code: \u043e\u043d \u0434\u0430\u0451\u0442 \u043f\u0440\u0430\u043a\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0442\u043e \u0436\u0435, \u0447\u0442\u043e \u043e\u043d\u043b\u0430\u0439\u043d\u043e\u0432\u044b\u0439 Swagger Editor, \u043d\u043e \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e \u2014 \u0440\u0435\u043d\u0434\u0435\u0440\u0435\u043d\u043d\u044b\u0439 preview \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 (\u0447\u0435\u0440\u0435\u0437 Swagger UI \u0438\u043b\u0438 ReDoc), \u0430\u0432\u0442\u043e\u0434\u043e\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435 (IntelliSense), \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044e \u043f\u043e \u0441\u0441\u044b\u043b\u043a\u0430\u043c, \u043f\u0435\u0440\u0435\u0445\u043e\u0434 \u043a \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044e \u0438 \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u0439 \u043b\u0438\u043d\u0442\u0438\u043d\u0433. \u0411\u0430\u0437\u043e\u0432\u044b\u0439 \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u0438 \u043d\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438; \u0435\u0441\u0442\u044c \u0438 \u0431\u043e\u043b\u0435\u0435 \u0442\u044f\u0436\u0451\u043b\u044b\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u0430\u0443\u0434\u0438\u0442\u0430 \u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u0438, \u0447\u0430\u0441\u0442\u044c \u0438\u0437 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u0438. \u0420\u044f\u0434\u043e\u043c \u0441\u0442\u043e\u0438\u0442 \u043d\u0430\u0437\u0432\u0430\u0442\u044c \u0435\u0449\u0451 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432: \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435 Redocly OpenAPI \u0434\u043b\u044f VS Code (\u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f, \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044f \u043f\u043e\u00a0$ref<\/code>\u00a0\u0438 preview \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u2014 \u043f\u0440\u0430\u0432\u0434\u0430, \u0434\u043b\u044f preview \u043d\u0443\u0436\u0435\u043d \u043a\u043b\u044e\u0447 Redocly); Stoplight Studio \u2014 \u0432\u0438\u0437\u0443\u0430\u043b\u044c\u043d\u044b\u0439 \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0439 \u0441\u043e \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u043c mock-\u0441\u0435\u0440\u0432\u0435\u0440\u043e\u043c \u043d\u0430 Prism; Insomnia \u043e\u0442 Kong \u2014 \u043a\u043b\u0438\u0435\u043d\u0442 \u0441 \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u043c OpenAPI-\u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u043e\u043c \u0438 live-preview, \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u043c \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u0435\u043c \u0438 \u043b\u0438\u043d\u0442\u0438\u043d\u0433\u043e\u043c \u0447\u0435\u0440\u0435\u0437 Inso CLI; \u0438 Apidog \u2014 \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u0430\u044f \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0430, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043e\u0431\u044a\u0435\u0434\u0438\u043d\u044f\u0435\u0442 \u0434\u0438\u0437\u0430\u0439\u043d, \u043e\u0442\u043b\u0430\u0434\u043a\u0443, mock \u0438 \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 API \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435. \u0417\u0434\u0435\u0441\u044c \u0441\u0442\u043e\u0438\u0442 \u043e\u0442\u043c\u0435\u0442\u0438\u0442\u044c \u0440\u0430\u0437\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u043d\u0430 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e\u0435 \u0438 \u043e\u0431\u043b\u0430\u0447\u043d\u043e\u0435: VS Code-\u043f\u043b\u0430\u0433\u0438\u043d\u044b 42Crunch \u0438 Redocly, \u0430 \u0442\u0430\u043a\u0436\u0435 Stoplight Studio \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e; Insomnia \u0443\u043c\u0435\u0435\u0442 \u0445\u0440\u0430\u043d\u0438\u0442\u044c \u0434\u0430\u043d\u043d\u044b\u0435 \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e (Local Vault); Apidog \u0436\u0435 \u2014 \u0432 \u043e\u0441\u043d\u043e\u0432\u0435 \u0441\u0432\u043e\u0435\u0439 \u043e\u0431\u043b\u0430\u0447\u043d\u0430\u044f \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0430, \u0438 \u044d\u0442\u043e \u043d\u0443\u0436\u043d\u043e \u0443\u0447\u0438\u0442\u044b\u0432\u0430\u0442\u044c \u043a\u043e\u043c\u0430\u043d\u0434\u0430\u043c \u0441 \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f\u043c\u0438 \u043a \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044e \u0434\u0430\u043d\u043d\u044b\u0445.<\/p>\n
\u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: \u043d\u0438 \u043e\u0434\u0438\u043d \u0438\u0437 \u044d\u0442\u0438\u0445 \u043f\u0443\u043d\u043a\u0442\u043e\u0432 \u043d\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u043a\u043e\u0434\u0430. \u0414\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u0432\u0430\u0448\u0430 \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u043f\u0440\u0438\u043d\u0446\u0438\u043f\u0438\u0430\u043b\u044c\u043d\u043e \u043f\u0438\u0448\u0435\u0442 \u0432\u0435\u0441\u044c \u0441\u0435\u0442\u0435\u0432\u043e\u0439 \u0441\u043b\u043e\u0439 \u0440\u0443\u043a\u0430\u043c\u0438, \u0432\u044b \u0432\u0441\u0451 \u0440\u0430\u0432\u043d\u043e \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0435 \u043b\u0438\u043d\u0442\u0438\u043d\u0433, \u043c\u043e\u043a\u0438, \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043d\u044b\u0435 \u0442\u0435\u0441\u0442\u044b, \u0447\u0435\u0441\u0442\u043d\u0443\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0438 \u0437\u0430\u0449\u0438\u0442\u0443 \u043e\u0442 breaking changes. \u0412\u043e\u0442 \u043f\u043e\u0447\u0435\u043c\u0443 \u044f \u0441\u0447\u0438\u0442\u0430\u044e, \u0447\u0442\u043e \u0441\u043f\u043e\u0440 \u00ab\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u043e\u0434 \u0438\u043b\u0438 \u043d\u0435\u0442\u00bb \u2014 \u0432\u0442\u043e\u0440\u0438\u0447\u0435\u043d \u043f\u043e \u043e\u0442\u043d\u043e\u0448\u0435\u043d\u0438\u044e \u043a \u0440\u0435\u0448\u0435\u043d\u0438\u044e \u00ab\u0438\u043c\u0435\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0438\u043b\u0438 \u043d\u0435\u0442\u00bb.<\/p>\n
\u041e \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043a\u0430\u0445<\/h3>\n
\u0410\u043f\u043e\u043b\u043e\u0433\u0438\u044f \u0432 \u043a\u043b\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043a\u043e\u043c \u0441\u043c\u044b\u0441\u043b\u0435 \u2014 \u044d\u0442\u043e \u0437\u0430\u0449\u0438\u0442\u0430, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043d\u0435 \u043f\u0440\u044f\u0447\u0435\u0442 \u043d\u0435\u0443\u0434\u043e\u0431\u043d\u044b\u0435 \u0444\u0430\u043a\u0442\u044b. \u0412\u043e\u0442 \u043e\u043d\u0438.<\/p>\n
**\u041f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c \u0438 \u0434\u0438\u0441\u043a\u0440\u0438\u043c\u0438\u043d\u0430\u0442\u043e\u0440\u044b \u2014 \u044d\u0442\u043e \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0431\u043e\u043b\u044c\u043d\u043e (\u043d\u043e \u0440\u0435\u0436\u0435, \u0447\u0435\u043c \u043a\u0430\u0436\u0435\u0442\u0441\u044f).<\/strong>\u00a0\u0421\u043d\u0430\u0447\u0430\u043b\u0430 \u043e \u043c\u0430\u0441\u0448\u0442\u0430\u0431\u0435. \u041f\u043e\u0434\u0430\u0432\u043b\u044f\u044e\u0449\u0435\u0435 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u0442\u0438\u043f\u043e\u0432 \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0439 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u2014 \u044d\u0442\u043e \u043f\u0440\u043e\u0441\u0442\u044b\u0435 \u043f\u043b\u043e\u0441\u043a\u0438\u0435 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u044b, \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u044b\u0435 \u0447\u0435\u0440\u0435\u0437\u00a0$ref<\/code>; \u0434\u043b\u044f \u043d\u0438\u0445 \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u0438 \u0432\u0435\u0441\u044c \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u043e\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0439 \u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0442 \u0431\u0435\u0437\u0443\u043f\u0440\u0435\u0447\u043d\u043e. \u041d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435 \u0447\u0435\u0440\u0435\u0437\u00a0allOf<\/code>, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u043c\u044b \u0442\u043e\u043b\u044c\u043a\u043e \u0447\u0442\u043e \u0445\u0432\u0430\u043b\u0438\u043b\u0438 \u0437\u0430 DRY, \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u044b \u0442\u043e\u0436\u0435, \u043a\u0430\u043a \u043f\u0440\u0430\u0432\u0438\u043b\u043e, \u043f\u0435\u0440\u0435\u0432\u0430\u0440\u0438\u0432\u0430\u044e\u0442 \u0431\u0435\u0437 \u0441\u044e\u0440\u043f\u0440\u0438\u0437\u043e\u0432. \u0418 \u0441\u0430\u043c\u00a0allOf<\/code>, \u0438 \u2014 \u0442\u0435\u043c \u0431\u043e\u043b\u0435\u0435 \u2014 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c \u0441 \u0434\u0438\u0441\u043a\u0440\u0438\u043c\u0438\u043d\u0430\u0442\u043e\u0440\u043e\u043c \u0432\u0441\u0442\u0440\u0435\u0447\u0430\u044e\u0442\u0441\u044f \u0432 \u0436\u0438\u0432\u044b\u0445 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430\u0445 \u0437\u0430\u043c\u0435\u0442\u043d\u043e \u0440\u0435\u0436\u0435 \u043f\u0440\u043e\u0441\u0442\u044b\u0445 \u043f\u043e\u0434\u0442\u0438\u043f\u043e\u0432. \u0411\u043e\u043b\u044c \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0438\u043c\u0435\u043d\u043d\u043e \u0441 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u043d\u044b\u0445 \u00ab\u0438\u043b\u0438-\u0438\u043b\u0438\u00bb \u0442\u0438\u043f\u043e\u0432 \u2014 \u043a\u043e\u0433\u0434\u0430 \u043e\u0431\u044a\u0435\u043a\u0442 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c\u00a0\u043e\u0434\u043d\u0438\u043c \u0438\u0437<\/em>\u00a0\u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u043e\u0432 (oneOf<\/code>\/anyOf<\/code>\u00a0\u0441 \u0434\u0438\u0441\u043a\u0440\u0438\u043c\u0438\u043d\u0430\u0442\u043e\u0440\u043e\u043c): \u0432\u043e\u0442 \u0437\u0434\u0435\u0441\u044c \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u044b \u0432\u0435\u0434\u0443\u0442 \u0441\u0435\u0431\u044f \u043f\u043e-\u0440\u0430\u0437\u043d\u043e\u043c\u0443 \u0438 \u043d\u0435\u0440\u0435\u0434\u043a\u043e \u0432\u044b\u0434\u0430\u044e\u0442 \u043d\u0435\u0443\u043a\u043b\u044e\u0436\u0438\u0439 \u043a\u043e\u0434.\u041d\u0430 Habr \u0435\u0441\u0442\u044c \u0434\u0435\u0442\u0430\u043b\u044c\u043d\u044b\u0439 \u0440\u0430\u0437\u0431\u043e\u0440 \u0438\u043c\u0435\u043d\u043d\u043e \u044d\u0442\u043e\u0439 \u0431\u043e\u043b\u0438 \u0432 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u0435 Java\/Spring (\u0441\u0442\u0430\u0442\u044c\u044f \u00ab\u0413\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 OpenApi \u0438\u043b\u0438 \u043f\u0440\u0438\u043a\u043b\u0430\u0434\u043d\u043e\u0439 API first: oneOf, anyOf, allOf\u00bb): \u0434\u0438\u0441\u043a\u0440\u0438\u043c\u0438\u043d\u0430\u0442\u043e\u0440 \u0442\u0430\u043c \u043e\u043f\u0438\u0441\u0430\u043d \u043a\u0430\u043a \u00ab\u0438\u043c\u0435\u043d\u043d\u043e \u0442\u0430 \u0432\u0435\u0449\u044c, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0443\u043f\u0440\u0430\u0432\u043b\u044f\u0442\u044c \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 \u043a\u043e\u0434\u0430 \u043f\u0440\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0438 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c\u0430\u00bb, \u0438 \u043e\u043d \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u0441\u043f\u0435\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0435 Java-\u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0438\u00a0@JsonSubTypes<\/code>. \u0412\u044b\u0432\u043e\u0434: \u0434\u0438\u0441\u043a\u0440\u0438\u043c\u0438\u043d\u0430\u0442\u043e\u0440 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442, \u043d\u043e \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u043e\u0441\u0442\u0438 \u0438 \u043f\u043e\u043d\u0438\u043c\u0430\u043d\u0438\u044f, \u043a\u0430\u043a \u0438\u043c\u0435\u043d\u043d\u043e \u0432\u0430\u0448 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u0442 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c \u0432 \u043a\u043e\u0434. \u041d\u0430 \u043a\u043b\u0438\u0435\u043d\u0442\u0435 \u0438\u0441\u0442\u043e\u0440\u0438\u044f \u043f\u043e\u0445\u043e\u0436\u0430\u044f. \u042d\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0435 \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0435 \u2014 \u043d\u043e, \u043a\u0430\u043a \u044f \u0438 \u0441\u043a\u0430\u0437\u0430\u043b, \u0441\u043a\u043e\u0440\u0435\u0435 \u0440\u0435\u0434\u043a\u0438\u0439 \u0443\u0433\u043e\u043b, \u0447\u0435\u043c \u0435\u0436\u0435\u0434\u043d\u0435\u0432\u043d\u0430\u044f \u043f\u0440\u0435\u0433\u0440\u0430\u0434\u0430: \u0434\u043b\u044f \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u0430 endpoints \u0432\u044b \u0435\u0433\u043e \u043f\u043e\u043f\u0440\u043e\u0441\u0442\u0443 \u043d\u0435 \u0432\u0441\u0442\u0440\u0435\u0442\u0438\u0442\u0435.<\/p>\n
\u042d\u0440\u0433\u043e\u043d\u043e\u043c\u0438\u043a\u0430 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430.<\/strong>\u00a0\u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043a\u043e\u0434 \u043f\u043e\u0447\u0442\u0438 \u0432\u0441\u0435\u0433\u0434\u0430 \u043e\u0431\u044a\u0451\u043c\u043d\u0435\u0435 \u0438 \u043c\u0435\u043d\u0435\u0435 \u00ab\u0440\u043e\u0434\u043d\u043e\u0439\u00bb, \u0447\u0435\u043c \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 \u0440\u0443\u043a\u0430\u043c\u0438. \u0418\u043c\u0435\u043d\u0430 \u0432 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u044e\u0442\u0441\u044f \u0432 \u0438\u043c\u0435\u043d\u0430 \u0432 \u043a\u043e\u0434\u0435 \u2014 \u00ab\u043a\u0440\u0438\u0432\u043e\u0439 \u043d\u0435\u0439\u043c\u0438\u043d\u0433 \u0432 \u0441\u043f\u0435\u043a\u0435 \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442 \u043a\u0440\u0438\u0432\u043e\u0439 \u043d\u0435\u0439\u043c\u0438\u043d\u0433 \u0432 \u043a\u043e\u0434\u0435\u00bb. \u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u044b \u0441\u043f\u043e\u0442\u044b\u043a\u0430\u044e\u0442\u0441\u044f \u043d\u0430 \u0430\u043d\u043e\u043d\u0438\u043c\u043d\u044b\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u0430\u0445 \u0438 \u043d\u0435\u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0445 \u043a\u043e\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u044f\u0445. \u041e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0439 swift-openapi-generator \u043d\u0430 Habr \u0443\u0436\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u043b \u0441\u043a\u0435\u043f\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u043e\u0431\u0437\u043e\u0440 \u043e\u0442 iOS-\u043a\u043e\u043c\u0430\u043d\u0434\u044b Ozon: \u0410\u043d\u0434\u0440\u0435\u0439, \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u00ab\u041f\u0443\u043d\u043a\u0442 Ozon\u00bb, \u0432 \u0441\u0442\u0430\u0442\u044c\u0435 \u00ab\u0413\u043e\u0442\u043e\u0432 \u043b\u0438 Swift OpenAPI Generator \u0434\u043b\u044f \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u0438\u0432\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430?<\/a>\u00bb \u0436\u0430\u043b\u0443\u0435\u0442\u0441\u044f \u043d\u0430 \u00ab\u043d\u0435\u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u043f\u043e\u0432\u043b\u0438\u044f\u0442\u044c \u043d\u0430 \u043f\u0440\u043e\u0446\u0435\u0441\u0441 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438\u00bb \u0438 \u043d\u0430 \u043e\u0447\u0435\u043d\u044c \u0434\u043e\u043b\u0433\u0443\u044e \u0441\u0431\u043e\u0440\u043a\u0443 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u2014 \u0443 \u043d\u0435\u0433\u043e \u043f\u0443\u0441\u0442\u043e\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u0441\u043e\u0431\u0438\u0440\u0430\u043b\u0441\u044f \u043e\u043a\u043e\u043b\u043e 105 \u0441\u0435\u043a\u0443\u043d\u0434 \u043d\u0430 MacBook Pro M1. \u0421 \u0442\u0435\u0445 \u043f\u043e\u0440 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u0437\u0430\u043c\u0435\u0442\u043d\u043e \u043f\u043e\u0432\u0437\u0440\u043e\u0441\u043b\u0435\u043b, \u043d\u043e \u0441\u0430\u043c \u0444\u0430\u043a\u0442 \u043f\u043e\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u0435\u043d: \u043a \u0432\u044b\u0431\u043e\u0440\u0443 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430 \u043d\u0443\u0436\u043d\u043e \u043f\u043e\u0434\u0445\u043e\u0434\u0438\u0442\u044c \u0442\u0440\u0435\u0437\u0432\u043e \u0438 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u043d\u0430 \u0441\u0432\u043e\u0451\u043c \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0435, \u0430 \u043d\u0435 \u043d\u0430 \u0443\u0447\u0435\u0431\u043d\u043e\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0435. \u0410 \u0435\u0449\u0451 \u0437\u0430 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u0438\u0441\u0442\u043e\u043c \u0432\u0441\u0435\u0433\u0434\u0430 \u0435\u0441\u0442\u044c \u0432\u044b\u0431\u043e\u0440 \u043e\u043f\u0446\u0438\u0438: \u0431\u0443\u0434\u0435\u0442 \u043b\u0438 \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0442\u044c\u0441\u044f \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437 \u043f\u0440\u0438 \u0441\u0431\u043e\u0440\u043a\u0435 \u0438\u043b\u0438 \u0432\u0440\u0443\u0447\u043d\u0443\u044e.<\/p>\n
\u0414\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u0430 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0438.<\/strong>\u00a0\u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0440\u043e\u0432\u043d\u043e \u043d\u0430\u0441\u0442\u043e\u043b\u044c\u043a\u043e, \u043d\u0430\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0430. \u0415\u0441\u043b\u0438 \u043f\u0440\u043e\u0446\u0435\u0441\u0441 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043c\u0435\u043d\u044f\u0442\u044c \u043a\u043e\u0434 \u0432 \u043e\u0431\u0445\u043e\u0434 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u0432\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0445\u0443\u0434\u0448\u0435\u0435 \u0438\u0437 \u0434\u0432\u0443\u0445 \u043c\u0438\u0440\u043e\u0432: \u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442, \u0438 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u044c, \u0438 \u043e\u0431\u0430 \u0432\u0440\u0443\u0442. \u0412 \u0440\u0443\u0441\u0441\u043a\u043e\u044f\u0437\u044b\u0447\u043d\u044b\u0445 \u043a\u0435\u0439\u0441\u0430\u0445 \u044d\u0442\u043e \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442 \u043f\u0440\u044f\u043c\u043e: \u0431\u044b\u0432\u0430\u0435\u0442, \u0447\u0442\u043e \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a \u043d\u0430\u0440\u0438\u0441\u043e\u0432\u0430\u043b \u0441\u0445\u0435\u043c\u0443, \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u043f\u043e \u0445\u043e\u0434\u0443 \u0434\u0435\u043b\u0430 \u043f\u043e\u043c\u0435\u043d\u044f\u043b \u0435\u0451 \u00ab\u0432 \u043a\u043e\u0434\u0435\u00bb, \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0449\u0438\u043a\u0438 \u0437\u0430\u0432\u0435\u043b\u0438 \u043f\u043e\u043b\u0441\u043e\u0442\u043d\u0438 \u0434\u0435\u0444\u0435\u043a\u0442\u043e\u0432 \u043f\u043e \u0441\u0445\u0435\u043c\u0435 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0430 \u2014 \u0438 \u0432\u044b\u044f\u0441\u043d\u0438\u043b\u043e\u0441\u044c, \u0447\u0442\u043e \u0435\u0434\u0438\u043d\u043e\u0433\u043e \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u043f\u0440\u0430\u0432\u0434\u044b \u043d\u0430 \u0441\u0430\u043c\u043e\u043c \u0434\u0435\u043b\u0435 \u043d\u0435\u0442. \u0424\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u043e\u0435 \u0432\u043d\u0435\u0434\u0440\u0435\u043d\u0438\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u0431\u0435\u0437 \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u044b \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0443 \u043d\u0435 \u0440\u0435\u0448\u0430\u0435\u0442, \u0430 \u043c\u0430\u0441\u043a\u0438\u0440\u0443\u0435\u0442.<\/p>\n
\u041f\u043e\u0434\u0445\u043e\u0434 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0440\u043e\u043b\u0435\u0439 \u0438 \u0432\u0440\u0435\u043c\u0435\u043d\u0438.<\/strong>\u00a0\u0422\u0430 \u0436\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u041c\u0422\u0421 \u043e\u0442\u043c\u0435\u0447\u0430\u0435\u0442: spec-first \u0445\u043e\u0440\u043e\u0448\u043e \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0442\u0430\u043c, \u0433\u0434\u0435 \u0435\u0441\u0442\u044c \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438 \u0438 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u043e\u0440\u044b, \u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0435 \u0437\u0430 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438, \u043b\u0438\u0431\u043e \u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432 \u0432\u044b\u0434\u0435\u043b\u0435\u043d\u043e \u0432\u0440\u0435\u043c\u044f \u043d\u0430 \u0438\u0445 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435. \u042d\u0442\u043e \u043d\u0435 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e. \u0418 \u044d\u0442\u043e \u043f\u043e\u0434\u0432\u043e\u0434\u0438\u0442 \u043d\u0430\u0441 \u043a \u0433\u043b\u0430\u0432\u043d\u043e\u043c\u0443 \u0432\u043e\u0437\u0440\u0430\u0436\u0435\u043d\u0438\u044e.<\/p>\n
\u00ab\u042d\u0442\u043e \u0436\u0435 \u043b\u0438\u0448\u043d\u044f\u044f \u0440\u0430\u0431\u043e\u0442\u0430 \u0434\u043b\u044f \u0431\u044d\u043a\u0435\u043d\u0434\u0430\u00bb<\/h3>\n
\u0421\u0430\u043c\u043e\u0435 \u0447\u0430\u0441\u0442\u043e\u0435 \u0432\u043e\u0437\u0440\u0430\u0436\u0435\u043d\u0438\u0435, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u044f \u0441\u043b\u044b\u0448\u0443: \u00ab\u0422\u0435\u0431\u0435, \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u043e\u043c\u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0443, \u0445\u043e\u0440\u043e\u0448\u043e \u2014 \u0430 \u043d\u0430\u043c, \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440\u0430\u043c, \u0442\u0435\u043f\u0435\u0440\u044c \u043f\u0438\u0441\u0430\u0442\u044c \u0435\u0449\u0451 \u0438 YAML-\u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u0440\u0443\u043a\u0430\u043c\u0438. \u042d\u0442\u043e \u043b\u0438\u0448\u043d\u044f\u044f \u0440\u0430\u0431\u043e\u0442\u0430\u00bb.<\/p>\n
\u0414\u0430\u0432\u0430\u0439\u0442\u0435 \u0440\u0430\u0437\u0431\u0435\u0440\u0451\u043c \u044d\u0442\u043e \u0432\u043e\u0437\u0440\u0430\u0436\u0435\u043d\u0438\u0435, \u043d\u0435 \u043e\u0442\u043c\u0430\u0445\u0438\u0432\u0430\u044f\u0441\u044c. \u0412 \u043d\u0451\u043c \u0435\u0441\u0442\u044c \u0434\u0432\u0435 \u0447\u0430\u0441\u0442\u0438, \u0438 \u0438\u0445 \u0432\u0430\u0436\u043d\u043e \u0440\u0430\u0437\u043b\u0438\u0447\u0430\u0442\u044c.<\/p>\n
\u041f\u0435\u0440\u0432\u0430\u044f \u0447\u0430\u0441\u0442\u044c \u2014 \u0440\u0435\u0430\u043b\u044c\u043d\u0430\u044f.<\/strong>\u00a0\u0414\u0430, \u0443 spec-first \u0435\u0441\u0442\u044c \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0430\u044f \u043f\u0435\u0440\u0432\u043e\u043d\u0430\u0447\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u043e\u0438\u043c\u043e\u0441\u0442\u044c. \u041a\u0442\u043e-\u0442\u043e \u0434\u043e\u043b\u0436\u0435\u043d \u0441\u0435\u0441\u0442\u044c \u0438 \u043d\u0430\u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0434\u043e \u043d\u0430\u0447\u0430\u043b\u0430 \u043a\u043e\u0434\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f. \u041d\u0430 \u043d\u043e\u0432\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u044d\u0442\u043e \u0447\u0430\u0441\u044b, \u0438\u043d\u043e\u0433\u0434\u0430 \u0434\u043d\u0438 \u0440\u0430\u0431\u043e\u0442\u044b \u043f\u0430\u0440\u044b \u0447\u0435\u043b\u043e\u0432\u0435\u043a. \u0414\u043b\u044f \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0431\u0435\u0437 \u0432\u044b\u0434\u0435\u043b\u0435\u043d\u043d\u044b\u0445 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u043e\u0432 \u044d\u0442\u043e \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442, \u0447\u0442\u043e \u043d\u0430\u0433\u0440\u0443\u0437\u043a\u0430 \u043b\u043e\u0436\u0438\u0442\u0441\u044f \u043d\u0430 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432. \u0422\u0430\u043a\u043e\u0432\u0430 \u0446\u0435\u043d\u0430, \u0438 \u043f\u0440\u0438\u0442\u0432\u043e\u0440\u044f\u0442\u044c\u0441\u044f, \u0447\u0442\u043e \u0435\u0451 \u043d\u0435\u0442, \u2014 \u043d\u0435\u0447\u0435\u0441\u0442\u043d\u043e. \u0411\u043e\u043b\u0435\u0435 \u0442\u043e\u0433\u043e, \u043f\u0440\u0438 code-first \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u0444\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u043e \u00ab\u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u0430\u00bb (\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0438\u0437 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0439), \u0438 \u0434\u043b\u044f \u043f\u0440\u043e\u0442\u043e\u0442\u0438\u043f\u043e\u0432, MVP \u0438 API, \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044c \u043a\u043e\u0442\u043e\u0440\u043e\u0433\u043e \u2014 \u0432\u044b \u0441\u0430\u043c\u0438, code-first \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0440\u0430\u0437\u0443\u043c\u043d\u0435\u0435. \u042f \u043d\u0435 \u0443\u0442\u0432\u0435\u0440\u0436\u0434\u0430\u044e, \u0447\u0442\u043e spec-first \u043d\u0443\u0436\u0435\u043d \u0432\u0441\u0435\u043c \u0438 \u0432\u0441\u0435\u0433\u0434\u0430.<\/p>\n
\u0412\u0442\u043e\u0440\u0430\u044f \u0447\u0430\u0441\u0442\u044c \u2014 \u044d\u0442\u043e \u0441\u043e\u043f\u0440\u043e\u0442\u0438\u0432\u043b\u0435\u043d\u0438\u0435 \u043d\u043e\u0432\u043e\u043c\u0443, \u0437\u0430\u043c\u0430\u0441\u043a\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0435 \u043f\u043e\u0434 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u043e \u0442\u0440\u0443\u0434\u043e\u0437\u0430\u0442\u0440\u0430\u0442\u0430\u0445.<\/strong>\u00a0\u0418 \u0432\u043e\u0442 \u0437\u0434\u0435\u0441\u044c \u0441\u0442\u043e\u0438\u0442 \u0431\u044b\u0442\u044c \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u044b\u043c. \u00ab\u041b\u0438\u0448\u043d\u044f\u044f \u0440\u0430\u0431\u043e\u0442\u0430\u00bb \u0432 \u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u043e\u0432\u043a\u0435 \u0432\u043e\u0437\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0447\u0430\u0441\u0442\u043e \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442 \u043d\u0435 \u00ab\u0441\u0443\u043c\u043c\u0430\u0440\u043d\u043e \u0431\u043e\u043b\u044c\u0448\u0435 \u0440\u0430\u0431\u043e\u0442\u044b\u00bb, \u0430 \u00ab\u043d\u043e\u0432\u0430\u044f \u0434\u043b\u044f \u043c\u0435\u043d\u044f \u0440\u0430\u0431\u043e\u0442\u0430, \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u044f \u0440\u0430\u043d\u044c\u0448\u0435 \u043d\u0435 \u0434\u0435\u043b\u0430\u043b \u0438 \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043d\u0435\u043e\u0445\u043e\u0442\u0430 \u043e\u0441\u0432\u0430\u0438\u0432\u0430\u0442\u044c\u00bb. \u042d\u0442\u043e \u043d\u043e\u0440\u043c\u0430\u043b\u044c\u043d\u0430\u044f \u0447\u0435\u043b\u043e\u0432\u0435\u0447\u0435\u0441\u043a\u0430\u044f \u0440\u0435\u0430\u043a\u0446\u0438\u044f \u2014 \u00ab\u043f\u0440\u0438\u0432\u044b\u0447\u043a\u0430 \u0448\u0442\u0443\u043a\u0430 \u0441\u0438\u043b\u044c\u043d\u0430\u044f\u00bb, \u043a\u0430\u043a \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e \u0437\u0430\u043c\u0435\u0447\u0435\u043d\u043e \u0432 \u043e\u0434\u043d\u043e\u043c \u0438\u0437 \u0443\u043f\u043e\u043c\u044f\u043d\u0443\u0442\u044b\u0445 habr-\u043a\u0435\u0439\u0441\u043e\u0432. \u041d\u043e \u044d\u0442\u043e \u043d\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u043e \u0442\u0440\u0443\u0434\u043e\u0437\u0430\u0442\u0440\u0430\u0442\u0430\u0445, \u044d\u0442\u043e \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442 \u043e \u0437\u043e\u043d\u0435 \u043a\u043e\u043c\u0444\u043e\u0440\u0442\u0430, \u0438 \u0435\u0433\u043e \u0441\u0442\u043e\u0438\u0442 \u043d\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u0441\u0432\u043e\u0438\u043c \u0438\u043c\u0435\u043d\u0435\u043c.<\/p>\n
\u041f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u0435\u0441\u043b\u0438 \u043f\u043e\u0441\u0447\u0438\u0442\u0430\u0442\u044c \u043f\u043e\u043b\u043d\u0443\u044e \u0441\u0442\u043e\u0438\u043c\u043e\u0441\u0442\u044c, \u043a\u0430\u0440\u0442\u0438\u043d\u0430 \u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f. \u0422\u0430 \u0440\u0430\u0431\u043e\u0442\u0430, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u00ab\u0438\u0441\u0447\u0435\u0437\u0430\u0435\u0442\u00bb \u043f\u0440\u0438 code-first, \u043d\u0430 \u0441\u0430\u043c\u043e\u043c \u0434\u0435\u043b\u0435 \u043d\u0435 \u0438\u0441\u0447\u0435\u0437\u0430\u0435\u0442 \u2014 \u043e\u043d\u0430 \u0440\u0430\u0437\u043c\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0438 \u043f\u0435\u0440\u0435\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u0434\u0440\u0443\u0433\u0438\u0445 \u0438 \u043d\u0430 \u043f\u043e\u0442\u043e\u043c. \u041c\u0430\u0442\u0432\u0435\u0439 \u041b\u0438\u0445\u043e\u0442\u0430 \u0438\u0437 \u041c\u0422\u0421 \u043f\u0440\u0438\u0432\u043e\u0434\u0438\u0442 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u0443\u044e \u0446\u0438\u0444\u0440\u0443: \u043d\u0430 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u0438 swagger-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0432 \u0434\u0435\u0441\u044f\u0442\u043a\u0435 \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u0443 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0443\u0445\u043e\u0434\u0438\u043b\u043e \u00ab\u0434\u043e 20% \u0432\u0440\u0435\u043c\u0435\u043d\u0438\u00bb, \u0430 \u043f\u043e\u0441\u043b\u0435 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0430 \u043d\u0430 Documentation-Driven Development \u00ab\u0432\u044b\u0441\u0432\u043e\u0431\u043e\u0434\u0438\u043b\u043e\u0441\u044c \u043e\u043a\u043e\u043b\u043e 20% \u0432\u0440\u0435\u043c\u0435\u043d\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432\u00bb. \u042d\u0442\u043e \u043d\u0435 \u00ab\u043b\u0438\u0448\u043d\u044f\u044f \u0440\u0430\u0431\u043e\u0442\u0430 \u0431\u044d\u043a\u0435\u043d\u0434\u0430\u00bb \u2014 \u044d\u0442\u043e \u0443\u0436\u0435 \u043f\u043e\u043d\u0435\u0441\u0451\u043d\u043d\u044b\u0435 \u043f\u043e\u0442\u0435\u0440\u0438, \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435\u0432\u0438\u0434\u0438\u043c\u044b\u0435, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043e\u043d\u0438 \u0440\u0430\u0437\u043c\u0430\u0437\u0430\u043d\u044b \u043f\u043e \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u043e\u043d\u043d\u044b\u043c \u0431\u0430\u0433\u0430\u043c, \u043f\u043e \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u043a\u0435 \u0432 \u0447\u0430\u0442\u0430\u0445, \u043f\u043e \u00ab\u0434\u0451\u0440\u043d\u0438 endpoint \u0432\u0436\u0438\u0432\u0443\u044e\u00bb, \u043f\u043e \u0441\u043b\u043e\u043c\u0430\u043d\u043d\u044b\u043c \u0443 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 \u043a\u043b\u0438\u0435\u043d\u0442\u0430\u043c \u043f\u043e\u0441\u043b\u0435 \u043d\u0435\u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u043d\u043e\u0433\u043e breaking change.<\/p>\n
\u0415\u0441\u043b\u0438 \u043f\u0435\u0440\u0435\u043d\u0435\u0441\u0442\u0438 \u0437\u0430\u0442\u0440\u0430\u0442\u044b \u0432 \u043d\u0430\u0447\u0430\u043b\u043e \u2014 \u043d\u0430\u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u0438 \u0441\u0442\u0440\u043e\u0433\u043e, \u2014 \u0442\u043e \u0434\u0430\u043b\u044c\u0448\u0435 \u0432\u044b\u0433\u043e\u0434\u0443 \u043f\u043e\u043b\u0443\u0447\u0430\u044e\u0442 \u0432\u0441\u0435: \u043e\u0448\u0438\u0431\u043a\u0438 \u043b\u043e\u0432\u044f\u0442\u0441\u044f \u043d\u0430 \u0440\u0435\u0432\u044c\u044e YAML \u0437\u0430 \u043c\u0438\u043d\u0443\u0442\u044b, \u0430 \u043d\u0435 \u0437\u0430 \u0434\u0435\u043d\u044c \u0434\u043e \u0440\u0435\u043b\u0438\u0437\u0430; \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0441\u0442\u0430\u0440\u0442\u0443\u044e\u0442 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e \u043d\u0430 \u043c\u043e\u043a\u0430\u0445; breaking changes \u043e\u0442\u043b\u0430\u0432\u043b\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438; \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u0451\u0442 \u0432\u0440\u0430\u0442\u044c. \u0422\u043e \u0435\u0441\u0442\u044c \u043e\u0442\u0432\u0435\u0442 \u043d\u0430 \u0432\u043e\u0437\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u0437\u0432\u0443\u0447\u0438\u0442 \u0442\u0430\u043a:\u00a0\u0434\u0430, \u044d\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u0430\u044f \u043f\u0435\u0440\u0432\u043e\u043d\u0430\u0447\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u043e\u0438\u043c\u043e\u0441\u0442\u044c \u0434\u043b\u044f \u0431\u044d\u043a\u0435\u043d\u0434\u0430, \u0438 \u0435\u0451 \u043d\u0430\u0434\u043e \u0437\u0430\u043b\u043e\u0436\u0438\u0442\u044c \u0432 \u043f\u043b\u0430\u043d; \u043d\u043e \u0437\u043d\u0430\u0447\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0447\u0430\u0441\u0442\u044c \u044d\u0442\u043e\u0439 \u00ab\u043d\u043e\u0432\u043e\u0439 \u0440\u0430\u0431\u043e\u0442\u044b\u00bb \u2014 \u044d\u0442\u043e \u043d\u0435 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0437\u0430\u0442\u0440\u0430\u0442\u044b, \u0430 \u043f\u0435\u0440\u0435\u043d\u0435\u0441\u0451\u043d\u043d\u044b\u0435 \u0432 \u043d\u0430\u0447\u0430\u043b\u043e \u0438 \u0441\u0434\u0435\u043b\u0430\u043d\u043d\u044b\u0435 \u044f\u0432\u043d\u044b\u043c\u0438 \u0442\u0435 \u0437\u0430\u0442\u0440\u0430\u0442\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u0438 \u0442\u0430\u043a \u043d\u0435\u0441\u0451\u0442, \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043e\u0437\u0436\u0435, \u0434\u043e\u0440\u043e\u0436\u0435 \u0438 \u0447\u0443\u0436\u0438\u043c\u0438 \u0440\u0443\u043a\u0430\u043c\u0438.<\/strong><\/p>\n
\u0418 \u0435\u0449\u0451 \u043e\u0434\u043d\u0430 \u0434\u0435\u0442\u0430\u043b\u044c, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0441\u043d\u0438\u043c\u0430\u0435\u0442 \u043d\u0430\u043f\u0440\u044f\u0436\u0435\u043d\u0438\u0435: \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u043d\u0435 \u043e\u0431\u044f\u0437\u0430\u043d \u043f\u0438\u0441\u0430\u0442\u044c \u0432 \u043e\u0434\u0438\u043d\u043e\u0447\u043a\u0443 \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440. \u0415\u0433\u043e \u0447\u0435\u0440\u043d\u043e\u0432\u0438\u043a \u043e\u0442\u043b\u0438\u0447\u043d\u043e \u043f\u0438\u0448\u0443\u0442 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438 \u0438 \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0449\u0438\u043a\u0438, \u0430 \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 \u043d\u0430\u043a\u043e\u043d\u0435\u0446-\u0442\u043e \u043f\u043e\u043b\u0443\u0447\u0430\u044e\u0442 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0432\u043b\u0438\u044f\u0442\u044c \u043d\u0430 API \u043d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u2014 \u043f\u0440\u0438\u043d\u043e\u0441\u0438\u0442\u044c \u043d\u0435 JSON-\u0444\u0430\u0439\u043b \u00ab\u0445\u043e\u0447\u0443 \u0432\u043e\u0442 \u0442\u0430\u043a\u00bb, \u0430 pull request \u043a \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438. \u042d\u0442\u043e \u0440\u0430\u0437\u0432\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442 \u043e\u0431\u044b\u0447\u043d\u0443\u044e \u0434\u0438\u043d\u0430\u043c\u0438\u043a\u0443, \u0433\u0434\u0435 \u00ab\u0431\u044d\u043a\u0435\u043d\u0434 \u043c\u043e\u0436\u0435\u0442 \u043f\u043e\u043c\u0435\u043d\u044f\u0442\u044c API \u0432 \u043b\u044e\u0431\u043e\u0439 \u043c\u043e\u043c\u0435\u043d\u0442, \u0430 \u043a\u043b\u0438\u0435\u043d\u0442 \u043e\u0431\u044f\u0437\u0430\u043d \u043f\u043e\u0434\u0441\u0442\u0440\u043e\u0438\u0442\u044c\u0441\u044f\u00bb, \u0432 \u0441\u0442\u043e\u0440\u043e\u043d\u0443 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u043d\u043e \u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430.<\/p>\n
\u041a\u0430\u043a \u0432\u043d\u0435\u0434\u0440\u044f\u0442\u044c \u0431\u0435\u0437 \u0440\u0438\u0441\u043a\u0430: \u043f\u043e\u044d\u0442\u0430\u043f\u043d\u044b\u0439 \u043f\u043b\u0430\u043d<\/h3>\n
\u0420\u0435\u0437\u043a\u043e \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0438\u0442\u044c \u043d\u0430 \u043f\u043e\u043b\u043d\u044b\u0439 Contract-First \u0432\u0441\u0435\u0439 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0435\u0439 \u2014 \u0441\u043c\u0435\u043b\u0430\u044f \u0438\u0434\u0435\u044f. \u041f\u043e\u0434\u0445\u043e\u0434 \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u044b, \u0430 \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u0430 \u043d\u0435 \u0432\u0432\u043e\u0434\u0438\u0442\u0441\u044f \u043f\u0440\u0438\u043a\u0430\u0437\u043e\u043c. \u0413\u043e\u0440\u0430\u0437\u0434\u043e \u043d\u0430\u0434\u0451\u0436\u043d\u0435\u0435 \u0434\u0432\u0438\u0433\u0430\u0442\u044c\u0441\u044f \u043c\u0430\u043b\u0435\u043d\u044c\u043a\u0438\u043c\u0438 \u0448\u0430\u0433\u0430\u043c\u0438, \u043d\u0430 \u043a\u0430\u0436\u0434\u043e\u043c \u0438\u0437 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u0432\u044b \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0435 \u043f\u043e\u043b\u044c\u0437\u0443, \u0434\u0430\u0436\u0435 \u0435\u0441\u043b\u0438 \u043e\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0435\u0441\u044c.<\/p>\n
    \n
  1. \n
    \u041d\u0430\u0447\u043d\u0438\u0442\u0435 \u0441 \u043e\u0434\u043d\u043e\u0433\u043e \u0441\u0435\u0440\u0432\u0438\u0441\u0430 \u0438\u043b\u0438 \u0434\u0430\u0436\u0435 \u043e\u0434\u043d\u043e\u0433\u043e \u0434\u043e\u043c\u0435\u043d\u0430.<\/strong>\u00a0\u0421\u0434\u0435\u043b\u0430\u0439\u0442\u0435 \u0435\u0433\u043e \u044d\u0442\u0430\u043b\u043e\u043d\u043d\u044b\u043c. \u041d\u0435 \u043f\u044b\u0442\u0430\u0439\u0442\u0435\u0441\u044c \u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0441\u0440\u0430\u0437\u0443 \u0432\u0441\u0451 \u2014 \u044d\u0442\u043e \u043f\u0443\u0442\u044c \u043a \u0432\u044b\u0433\u043e\u0440\u0430\u043d\u0438\u044e \u0438 \u0431\u0440\u043e\u0448\u0435\u043d\u043d\u043e\u0439 \u0437\u0430\u0442\u0435\u0435.<\/p>\n<\/li>\n
  2. \n
    \u0415\u0441\u043b\u0438 API \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u2014 \u043d\u0435 \u043f\u0438\u0448\u0438\u0442\u0435 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0441 \u043d\u0443\u043b\u044f.<\/strong>\u00a0\u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0439\u0442\u0435 \u0447\u0435\u0440\u043d\u043e\u0432\u0438\u043a \u0438\u0437 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u0442\u0440\u0430\u0444\u0438\u043a\u0430 \u0438\u043b\u0438 \u0438\u0437 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0445 Postman-\u043a\u043e\u043b\u043b\u0435\u043a\u0446\u0438\u0439, \u0430 \u043f\u043e\u0442\u043e\u043c \u0434\u043e\u0432\u0435\u0434\u0438\u0442\u0435 \u0435\u0433\u043e \u0440\u0443\u043a\u0430\u043c\u0438.<\/p>\n<\/li>\n
  3. \n
    \u0414\u043e\u0433\u043e\u0432\u043e\u0440\u0438\u0442\u0435\u0441\u044c \u043e \u043a\u043e\u043d\u0432\u0435\u043d\u0446\u0438\u044f\u0445 \u0438 \u0432\u043a\u043b\u044e\u0447\u0438\u0442\u0435 \u043b\u0438\u043d\u0442\u0435\u0440.<\/strong>\u00a0\u041f\u0440\u0435\u0436\u0434\u0435 \u0447\u0435\u043c \u043c\u0430\u0441\u0448\u0442\u0430\u0431\u0438\u0440\u043e\u0432\u0430\u0442\u044c, \u043e\u043f\u0438\u0448\u0438\u0442\u0435, \u043a\u0430\u043a \u0443 \u0432\u0430\u0441 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u00ab\u0445\u043e\u0440\u043e\u0448\u0435\u0435\u00bb API, \u0438 \u0437\u0430\u043a\u0440\u0435\u043f\u0438\u0442\u0435 \u044d\u0442\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u0430\u043c\u0438 Spectral \u0432 CI. \u0418\u043d\u0430\u0447\u0435 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u0431\u0443\u0434\u0435\u0442 \u0432 \u0441\u0432\u043e\u0451\u043c \u0441\u0442\u0438\u043b\u0435.<\/p>\n<\/li>\n
  4. \n
    \u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u0435 \u043c\u043e\u043a\u0438 \u0438 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043d\u044b\u0435 \u0442\u0435\u0441\u0442\u044b \u0434\u043e \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438.<\/strong>\u00a0\u042d\u0442\u043e \u0441\u0430\u043c\u044b\u0435 \u0431\u044b\u0441\u0442\u0440\u044b\u0435 \u043f\u043e\u0431\u0435\u0434\u044b \u0441 \u043d\u0430\u0438\u043c\u0435\u043d\u044c\u0448\u0438\u043c \u0440\u0438\u0441\u043a\u043e\u043c: \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0442 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e, \u0430 \u0434\u0440\u0435\u0439\u0444 \u043e\u0442\u043b\u0430\u0432\u043b\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438. \u041a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044e \u043c\u043e\u0436\u043d\u043e \u043e\u0442\u043b\u043e\u0436\u0438\u0442\u044c.<\/p>\n<\/li>\n
  5. \n
    \u041f\u043e\u0441\u0442\u0430\u0432\u044c\u0442\u0435 \u0432 CI \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 breaking changes.<\/strong>\u00a0oasdiff \u043d\u0430 pull request \u043a \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u0438 \u2014 \u0434\u0451\u0448\u0435\u0432\u043e \u0432\u043d\u0435\u0434\u0440\u0438\u0442\u044c, \u0434\u043e\u0440\u043e\u0433\u043e \u043d\u0435\u0434\u043e\u043e\u0446\u0435\u043d\u0438\u0442\u044c.<\/p>\n<\/li>\n
  6. \n
    \u041a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f<\/strong>, \u0442\u0430\u043c \u0433\u0434\u0435 \u043e\u043d\u0430 \u043e\u043f\u0440\u0430\u0432\u0434\u0430\u043d\u0430, \u0438 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0441 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u043e\u0439 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0430 \u043d\u0430 \u0432\u0430\u0448\u0435\u043c \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0435, \u0430 \u043d\u0435 \u043d\u0430 \u0443\u0447\u0435\u0431\u043d\u043e\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0435.<\/p>\n<\/li>\n<\/ol>\n
    \u0427\u0442\u043e \u0434\u043e\u043b\u0436\u043d\u043e \u043e\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c \u0432\u0430\u0441 \u0438 \u0437\u0430\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u043f\u0435\u0440\u0435\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043f\u043b\u0430\u043d: \u0435\u0441\u043b\u0438 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0442 \u043f\u0440\u0430\u0432\u0438\u0442\u044c \u0432 \u043e\u0431\u0445\u043e\u0434 (\u043a\u043e\u0434 \u0440\u0430\u0437\u043e\u0448\u0451\u043b\u0441\u044f \u0441 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u043c \u0438 \u044d\u0442\u043e \u043d\u0438\u043a\u043e\u0433\u043e \u043d\u0435 \u0431\u0435\u0441\u043f\u043e\u043a\u043e\u0438\u0442) \u2014 \u0437\u043d\u0430\u0447\u0438\u0442, \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u044b \u043d\u0435\u0442, \u0438 \u043f\u0440\u0435\u0436\u0434\u0435 \u0447\u0435\u043c \u0438\u0434\u0442\u0438 \u0434\u0430\u043b\u044c\u0448\u0435, \u043d\u0443\u0436\u043d\u043e \u0447\u0438\u043d\u0438\u0442\u044c \u043f\u0440\u043e\u0446\u0435\u0441\u0441, \u0430 \u043d\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0442\u044c \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b. \u041a\u043e\u043d\u0442\u0440\u0430\u043a\u0442 \u0431\u0435\u0437 \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u044b \u2014 \u044d\u0442\u043e \u043f\u0440\u043e\u0441\u0442\u043e \u0435\u0449\u0451 \u043e\u0434\u0438\u043d \u0432\u0440\u0443\u0449\u0438\u0439 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043f\u0440\u0430\u0432\u0434\u044b.<\/p>\n
    \u0412\u044b\u0432\u043e\u0434<\/h3>\n
    OpenAPI \u2014 \u044d\u0442\u043e \u043d\u0435 \u043f\u0440\u043e \u0442\u043e, \u0447\u0442\u043e\u0431\u044b \u00ab\u043d\u0435 \u043f\u0438\u0441\u0430\u0442\u044c \u043a\u043e\u0434 \u0440\u0443\u043a\u0430\u043c\u0438\u00bb. \u042d\u0442\u043e \u043f\u0440\u043e \u0442\u043e, \u0447\u0442\u043e\u0431\u044b \u0443 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0431\u044b\u043b \u043e\u0434\u0438\u043d \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u043f\u0440\u0430\u0432\u0434\u044b \u043e \u0442\u043e\u043c, \u043a\u0430\u043a \u0443\u0441\u0442\u0440\u043e\u0435\u043d API, \u0438 \u0447\u0442\u043e\u0431\u044b \u044d\u0442\u043e\u0442 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u0431\u044b\u043b \u043c\u0430\u0448\u0438\u043d\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u044b\u043c, \u0430 \u0437\u043d\u0430\u0447\u0438\u0442 \u2014 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u043c\u044b\u043c, \u0442\u0435\u0441\u0442\u0438\u0440\u0443\u0435\u043c\u044b\u043c \u0438 \u043d\u0435\u0441\u043f\u043e\u0441\u043e\u0431\u043d\u044b\u043c \u043d\u0435\u0437\u0430\u043c\u0435\u0442\u043d\u043e \u0440\u0430\u0437\u043e\u0439\u0442\u0438\u0441\u044c \u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u044c\u044e. \u041a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u2014 \u043f\u0440\u0438\u044f\u0442\u043d\u044b\u0439 \u0431\u043e\u043d\u0443\u0441 \u0441\u043e \u0441\u0432\u043e\u0435\u0439 \u0446\u0435\u043d\u043e\u0439; \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0430\u044f \u0432\u044b\u0433\u043e\u0434\u0430 \u2014 \u0432 \u0447\u0435\u0441\u0442\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u043c\u043e\u043a\u0430\u0445, \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043d\u044b\u0445 \u0442\u0435\u0441\u0442\u0430\u0445, \u043b\u0438\u043d\u0442\u0438\u043d\u0433\u0435 \u0438 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u043e\u0439 \u043b\u043e\u0432\u043b\u0435 breaking changes.<\/p>\n
    \u0423 \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u0435\u0441\u0442\u044c \u0446\u0435\u043d\u0430 \u0438 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u0441\u043b\u0430\u0431\u044b\u0435 \u043c\u0435\u0441\u0442\u0430: \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c \u043d\u0435\u0443\u0434\u043e\u0431\u0435\u043d, \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043a\u043e\u0434 \u043d\u0435 \u0432\u0441\u0435\u0433\u0434\u0430 \u043a\u0440\u0430\u0441\u0438\u0432, \u0430 \u0432\u0435\u0441\u044c \u043f\u043e\u0434\u0445\u043e\u0434 \u0434\u0435\u0440\u0436\u0438\u0442\u0441\u044f \u043d\u0430 \u0434\u0438\u0441\u0446\u0438\u043f\u043b\u0438\u043d\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b (\u0432\u043f\u0440\u043e\u0447\u0435\u043c \u043a\u0430\u043a \u0438 \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0435 \u043f\u043e\u0434\u0445\u043e\u0434\u044b). \u0412\u043e\u0437\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u00ab\u044d\u0442\u043e \u043b\u0438\u0448\u043d\u044f\u044f \u0440\u0430\u0431\u043e\u0442\u0430\u00bb \u043e\u0442\u0447\u0430\u0441\u0442\u0438 \u0441\u043f\u0440\u0430\u0432\u0435\u0434\u043b\u0438\u0432\u043e \u2014 \u043f\u0435\u0440\u0432\u043e\u043d\u0430\u0447\u0430\u043b\u044c\u043d\u0430\u044f \u0441\u0442\u043e\u0438\u043c\u043e\u0441\u0442\u044c \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0442\u0435\u043b\u044c\u043d\u043e \u0435\u0441\u0442\u044c, \u0438 \u0435\u0451 \u043d\u0430\u0434\u043e \u0437\u0430\u043a\u043b\u0430\u0434\u044b\u0432\u0430\u0442\u044c; \u043d\u043e \u0432\u0442\u043e\u0440\u0430\u044f \u043f\u043e\u043b\u043e\u0432\u0438\u043d\u0430 \u044d\u0442\u043e\u0439 \u00ab\u0440\u0430\u0431\u043e\u0442\u044b\u00bb \u2014 \u044d\u0442\u043e \u043d\u0435 \u043d\u043e\u0432\u044b\u0435 \u0437\u0430\u0442\u0440\u0430\u0442\u044b, \u0430 \u0441\u0442\u0430\u0440\u044b\u0435, \u043f\u0435\u0440\u0435\u043d\u0435\u0441\u0451\u043d\u043d\u044b\u0435 \u0432 \u043d\u0430\u0447\u0430\u043b\u043e \u0438 \u0441\u0434\u0435\u043b\u0430\u043d\u043d\u044b\u0435 \u0432\u0438\u0434\u0438\u043c\u044b\u043c\u0438.<\/p>\n
    \u041d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u0434\u043b\u044f \u043a\u043e\u043c\u0430\u043d\u0434\u044b, \u0433\u0434\u0435 \u0443 API \u0431\u043e\u043b\u044c\u0448\u0435 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044f, \u044d\u0442\u043e\u0442 \u0440\u0430\u0437\u043c\u0435\u043d \u043f\u043e\u0447\u0442\u0438 \u0432\u0441\u0435\u0433\u0434\u0430 \u0432\u044b\u0433\u043e\u0434\u0435\u043d. \u0412\u0438\u043a\u0438 \u0432\u0440\u0451\u0442, \u043f\u0440\u043e\u0434 \u043c\u043e\u043b\u0447\u0438\u0442, \u0430 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442, \u0435\u0441\u043b\u0438 \u043e\u0442\u043d\u043e\u0441\u0438\u0442\u044c\u0441\u044f \u043a \u043d\u0435\u043c\u0443 \u0441\u0435\u0440\u044c\u0451\u0437\u043d\u043e, \u0433\u043e\u0432\u043e\u0440\u0438\u0442 \u043f\u0440\u0430\u0432\u0434\u0443. \u0415\u0441\u043b\u0438 \u0434\u0430\u0442\u044c \u0435\u043c\u0443 \u0442\u0430\u043a\u0443\u044e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c.<\/p>\n<\/div>\n
    \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\/1044340\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
    \u041a\u043e\u0440\u043e\u0442\u043a\u0430\u044f \u0441\u0443\u0442\u044c.\u00a0\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043a\u043e\u043c\u0430\u043d\u0434\u044b \u0434\u043e \u0441\u0438\u0445 \u043f\u043e\u0440 \u0445\u0440\u0430\u043d\u044f\u0442 \u00ab\u043f\u0440\u0430\u0432\u0434\u0443\u00bb \u043e\u0431 API \u0432 \u0442\u0440\u0451\u0445 \u043d\u0435\u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u044b\u0445 \u043c\u0435\u0441\u0442\u0430\u0445: \u0432 \u0433\u043e\u043b\u043e\u0432\u0435 \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440\u0430, \u0432 \u0441\u0442\u0440\u0430\u043d\u0438\u0447\u043a\u0435 Confluence, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u0443\u0441\u0442\u0430\u0440\u0435\u043b\u0430 \u0435\u0449\u0451 \u043f\u0440\u043e\u0448\u043b\u043e\u0439 \u0432\u0435\u0441\u043d\u043e\u0439, \u0438 \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c JSON, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0438\u043b\u0435\u0442\u0430\u0435\u0442 \u0441 \u043f\u0440\u043e\u0434\u0430. \u042d\u0442\u0438 \u0442\u0440\u0438 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u043f\u043e\u0441\u0442\u043e\u044f\u043d\u043d\u043e \u0440\u0430\u0441\u0445\u043e\u0434\u044f\u0442\u0441\u044f, \u0438 \u0440\u0430\u0441\u043f\u043b\u0430\u0447\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u0437\u0430 \u044d\u0442\u043e \u0432\u0441\u0435 \u2014 \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438. OpenAPI \u2014 \u044d\u0442\u043e \u0441\u043f\u043e\u0441\u043e\u0431 \u0441\u0432\u0435\u0441\u0442\u0438 \u043f\u0440\u0430\u0432\u0434\u0443 \u043a \u043e\u0434\u043d\u043e\u043c\u0443 \u0444\u0430\u0439\u043b\u0443-\u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0443, \u043f\u043e\u043d\u044f\u0442\u043d\u043e\u043c\u0443 \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a\u0443, \u0438 \u043c\u0430\u0448\u0438\u043d\u0435. \u0412 \u0441\u0442\u0430\u0442\u044c\u0435 \u044f \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u044e, \u0437\u0430\u0447\u0435\u043c \u044d\u0442\u043e \u043d\u0443\u0436\u043d\u043e, \u043f\u043e\u0447\u0435\u043c\u0443 \u043a\u043e\u0434\u043e\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u044f \u2014 \u0434\u0430\u043b\u0435\u043a\u043e \u043d\u0435 \u0433\u043b\u0430\u0432\u043d\u0430\u044f \u043f\u0440\u0438\u0447\u0438\u043d\u0430, \u043d\u043e \u043f\u0440\u0438 \u044d\u0442\u043e\u043c \u043f\u0440\u043e\u0433\u043e\u0432\u0430\u0440\u0438\u0432\u0430\u044e, \u0432\u043e \u0447\u0442\u043e \u0432\u043d\u0435\u0434\u0440\u0435\u043d\u0438\u0435 \u043e\u0431\u043e\u0439\u0434\u0451\u0442\u0441\u044f \u0431\u044d\u043a\u0435\u043d\u0434\u0443, \u0438 \u0433\u0434\u0435 \u0443 \u043f\u043e\u0434\u0445\u043e\u0434\u0430 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0435 \u0441\u043b\u0430\u0431\u044b\u0435 \u043c\u0435\u0441\u0442\u0430.\u0421\u0438\u0442\u0443\u0430\u0446\u0438\u044f\u042f \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a. \u0418\u043d\u043e\u0433\u0434\u0430 \u043f\u0440\u0438 \u0440\u0430\u0431\u043e\u0442\u0435 \u0441\u043e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430\u043c\u0438 \u0434\u0430\u043d\u043d\u044b\u0445 \u044f \u0438\u043c\u0435\u044e \u0434\u0435\u043b\u043e \u0441 endpoint-\u0430\u043c\u0438, \u0438\u0434\u0443 \u0432 \u0432\u0438\u043a\u0438, \u043d\u0430\u0445\u043e\u0436\u0443 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0443 \u0441 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435\u043c \u2014 \u0438 \u043d\u0435 \u0432\u0435\u0440\u044e \u0435\u0439. \u041f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043f\u043e \u043e\u043f\u044b\u0442\u0443 \u0437\u043d\u0430\u044e: \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 API \u0442\u0430\u043a\u0438\u043c, \u043a\u0430\u043a\u0438\u043c \u043e\u043d \u0431\u044b\u043b \u0437\u0430\u0434\u0443\u043c\u0430\u043d \u043f\u043e\u043b\u0433\u043e\u0434\u0430 \u043d\u0430\u0437\u0430\u0434, \u0430 \u043d\u0435 \u0442\u0430\u043a\u0438\u043c, \u043a\u0430\u043a\u043e\u0439 \u043e\u043d \u0441\u0435\u0439\u0447\u0430\u0441. \u0414\u0430\u043b\u044c\u0448\u0435 \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0437\u043d\u0430\u043a\u043e\u043c\u044b\u0439 \u0440\u0438\u0442\u0443\u0430\u043b: \u043f\u0438\u0448\u0443 \u0432 \u0447\u0430\u0442 \u0431\u044d\u043a\u0435\u043d\u0434\u0435\u0440\u0443, \u043e\u043d \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u00ab\u0433\u043b\u044f\u043d\u044c \u0432 \u0441\u0432\u0430\u0433\u0433\u0435\u0440\u0435\u00bb, \u0441\u0432\u0430\u0433\u0433\u0435\u0440 \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d \u0438\u0437 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u0439 \u0438 \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u043f\u0440\u0438\u0431\u043b\u0438\u0437\u0438\u0442\u0435\u043b\u044c\u043d\u0443\u044e \u043a\u0430\u0440\u0442\u0438\u043d\u0443, \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u043e\u0442\u0432\u0435\u0442 \u0441 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u043e\u0442 \u043d\u0435\u0451 \u043e\u0442\u043b\u0438\u0447\u0430\u0435\u0442\u0441\u044f, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u043e \u0441\u0435\u0440\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0438 \u0436\u0438\u0432\u0451\u0442 \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435, \u0430 \u043f\u0440\u0430\u0432\u0438\u043b\u043e \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u2014 \u0432 \u0434\u0440\u0443\u0433\u043e\u043c. \u0412 \u0438\u0442\u043e\u0433\u0435 \u044f \u0434\u0435\u043b\u0430\u044e \u0442\u043e, \u0447\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u043a\u043b\u0438\u0435\u043d\u0442\u0441\u043a\u0438\u0445 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432: \u0434\u0451\u0440\u0433\u0430\u044e endpoint \u00ab\u0432\u0436\u0438\u0432\u0443\u044e\u00bb, \u0441\u043c\u043e\u0442\u0440\u044e \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u0439 JSON \u0438 \u0432\u0435\u0440\u044e \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u043c\u0443. \u0422\u043e \u0436\u0435 \u0441\u0430\u043c\u043e\u0435 \u0431\u044b\u0432\u0430\u0435\u0442 \u0438 \u043f\u0440\u0438 \u0440\u0430\u0431\u043e\u0442\u0435 \u0441 \u0432\u043d\u0435\u0448\u043d\u0438\u043c\u0438 API (\u0432 \u0442\u043e\u043c \u0447\u0438\u0441\u043b\u0435 \u0438 \u0441\u043e\u043b\u0438\u0434\u043d\u044b\u0445 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0439).\u042d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430 \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0430 \u043f\u0440\u0430\u0432\u0434\u044b. \u0423 \u043d\u0430\u0441 \u043d\u0435 \u043e\u0434\u0438\u043d \u0438\u0441\u0442\u043e\u0447\u043d\u0438\u043a, \u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e, \u0438 \u043e\u043d\u0438 \u043a\u043e\u043d\u043a\u0443\u0440\u0438\u0440\u0443\u044e\u0442. \u0412\u0438\u043a\u0438 \u2014 \u044d\u0442\u043e \u043d\u0430\u043c\u0435\u0440\u0435\u043d\u0438\u0435. \u041a\u043e\u0434 \u0431\u044d\u043a\u0435\u043d\u0434\u0430 \u2014 \u044d\u0442\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f. \u0420\u0435\u0430\u043b\u044c\u043d\u044b\u0439 \u0442\u0440\u0430\u0444\u0438\u043a \u2014 \u044d\u0442\u043e \u0444\u0430\u043a\u0442. \u0418 \u043a\u043e\u0433\u0434\u0430 \u043c\u0435\u0436\u0434\u0443 \u043d\u0438\u043c\u0438 \u0432\u043e\u0437\u043d\u0438\u043a\u0430\u0435\u0442 \u0440\u0430\u0441\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u0435 (\u0430 \u043e\u043d\u043e \u0432\u043e\u0437\u043d\u0438\u043a\u0430\u0435\u0442 \u0432\u0441\u0435\u0433\u0434\u0430), \u0446\u0435\u043d\u0430 \u043e\u0448\u0438\u0431\u043a\u0438 \u043b\u043e\u0436\u0438\u0442\u0441\u044f \u0432 \u043f\u0435\u0440\u0432\u0443\u044e \u043e\u0447\u0435\u0440\u0435\u0434\u044c \u043d\u0430 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u044f API: \u043d\u0430 \u0444\u0440\u043e\u043d\u0442\u0435\u043d\u0434, \u043d\u0430 iOS, \u043d\u0430 Android, \u043d\u0430 \u0434\u0435\u0441\u043a\u0442\u043e\u043f, \u043d\u0430 \u0432\u043d\u0435\u0448\u043d\u0438\u0445 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0442\u043e\u0440\u043e\u0432.\u042d\u0442\u0443 \u0431\u043e\u043b\u044c \u043d\u0430 Habr \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u043b\u0438 \u043c\u043d\u043e\u0433\u0438\u0435. \u0410\u043b\u0435\u043a\u0441\u0435\u0439, Java-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u042eMoney, \u0432 \u0441\u0442\u0430\u0442\u044c\u0435 \u00ab\u041a\u0430\u043a \u0443\u043b\u0443\u0447\u0448\u0438\u0442\u044c \u043c\u0435\u0436\u0441\u0435\u0440\u0432\u0435\u0440\u043d\u043e\u0435 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0435 \u0438 \u0441\u044d\u043a\u043e\u043d\u043e\u043c\u0438\u0442\u044c \u0432\u0440\u0435\u043c\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430\u00bb \u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u0443\u0435\u0442 \u0435\u0451 \u043f\u0440\u0435\u0434\u0435\u043b\u044c\u043d\u043e \u043f\u0440\u044f\u043c\u043e: \u00abSwagger UI, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u043e\u043c \u043f\u043e \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u043c \u043a\u043b\u0430\u0441\u0441\u043e\u0432, \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u043e\u0447\u0435\u043d\u044c \u043f\u0440\u0438\u043c\u0435\u0440\u043d\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u0443 \u043d\u0430\u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u043e\u0442\u0434\u0430\u0451\u0442\u0441\u044f \u0438\u0437 API. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0444\u0440\u043e\u043d\u0442\u044b \u0438 \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0435 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 \u043d\u0435 \u043c\u043e\u0433\u0443\u0442 \u043d\u0430\u0447\u0430\u0442\u044c \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0443, \u043d\u0435 \u0432\u044b\u0437\u0432\u0430\u0432 endpoint \u043d\u0430 \u0436\u0438\u0432\u0443\u044e\u00bb. \u042d\u0442\u043e \u043d\u0435 \u0447\u044c\u044f-\u0442\u043e \u043b\u0438\u0447\u043d\u0430\u044f \u043d\u0435\u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u043e\u0441\u0442\u044c \u2014 \u044d\u0442\u043e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u044b\u0439 \u0438\u0437\u044a\u044f\u043d \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0430, \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043f\u0440\u0430\u0432\u0434\u0430 \u043d\u0435 \u0446\u0435\u043d\u0442\u0440\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d\u0430.\u0427\u0442\u043e \u0442\u0430\u043a\u043e\u0435 OpenAPI (\u0434\u043b\u044f \u0442\u0435\u0445, \u043a\u0442\u043e \u0435\u0449\u0451 \u043d\u0435 \u0441\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u043b\u0441\u044f)OpenAPI \u2014 \u044d\u0442\u043e \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u0439 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u044f HTTP-API (\u043f\u0440\u0435\u0436\u0434\u0435 \u0432\u0441\u0435\u0433\u043e \u0432 REST-\u0441\u0442\u0438\u043b\u0435) \u0432 \u043c\u0430\u0448\u0438\u043d\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u043e\u043c \u0432\u0438\u0434\u0435. \u0421\u0442\u043e\u0438\u0442 \u0441\u0440\u0430\u0437\u0443 \u043e\u0447\u0435\u0440\u0442\u0438\u0442\u044c \u0433\u0440\u0430\u043d\u0438\u0446\u0443: OpenAPI \u2014 \u043d\u0435 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u044f\u0437\u044b\u043a \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u043e\u0432 \u0438 \u043f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u043d\u0435 \u043b\u044e\u0431\u043e\u0439 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b. \u0414\u043b\u044f \u0441\u0442\u0440\u043e\u0433\u043e \u0442\u0438\u043f\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u043c\u0435\u0436\u0441\u0435\u0440\u0432\u0438\u0441\u043d\u043e\u0433\u043e \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f \u0435\u0441\u0442\u044c gRPC \u0441 Protobuf, \u0434\u043b\u044f API \u0441 \u0433\u0438\u0431\u043a\u0438\u043c\u0438 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u043c\u0438 \u2014 GraphQL \u0441\u043e \u0441\u0432\u043e\u0435\u0439 \u0441\u0438\u0441\u0442\u0435\u043c\u043e\u0439 \u0442\u0438\u043f\u043e\u0432, \u0434\u043b\u044f \u0441\u043e\u0431\u044b\u0442\u0438\u0439\u043d\u044b\u0445 \u0438 \u0431\u0440\u043e\u043a\u0435\u0440\u043d\u044b\u0445 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440 (Kafka, \u043e\u0447\u0435\u0440\u0435\u0434\u0438 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0439) \u2014 \u0440\u043e\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442 AsyncAPI. OpenAPI \u0436\u0435 \u0437\u0430\u043d\u0438\u043c\u0430\u0435\u0442 \u043d\u0438\u0448\u0443 REST\/HTTP \u2014 \u0438 \u0438\u043c\u0435\u043d\u043d\u043e \u0437\u0434\u0435\u0441\u044c, \u0433\u0434\u0435 \u0436\u0438\u0432\u0451\u0442 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e \u043a\u043b\u0438\u0435\u043d\u0442-\u0441\u0435\u0440\u0432\u0435\u0440\u043d\u044b\u0445 API \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0445 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u043e\u0432, \u043e\u043d \u0441\u0442\u0430\u043b \u0434\u0435-\u0444\u0430\u043a\u0442\u043e \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043e\u043c. \u0420\u0430\u043d\u044c\u0448\u0435 \u043e\u043d \u043d\u0430\u0437\u044b\u0432\u0430\u043b\u0441\u044f Swagger; \u0432 \u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435 2010-\u0445 \u0441\u043f\u0435\u0446\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u043f\u0435\u0440\u0435\u0434\u0430\u043b\u0438 \u043f\u043e\u0434 \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0435 OpenAPI Initiative (\u043e\u0431\u044a\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u0435 \u043f\u043e\u0434 \u043a\u0440\u044b\u043b\u043e\u043c Linux Foundation, \u0443\u0447\u0440\u0435\u0436\u0434\u0451\u043d\u043d\u043e\u0435 \u0442\u0430\u043a\u0438\u043c\u0438 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044f\u043c\u0438, \u043a\u0430\u043a Google, IBM, Microsoft, PayPal, SmartBear \u0438 \u0434\u0440\u0443\u0433\u0438\u043c\u0438), \u0438 \u0441\u0435\u0433\u043e\u0434\u043d\u044f Swagger \u2014 \u044d\u0442\u043e \u0443\u0436\u0435 \u043d\u0430\u0431\u043e\u0440 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432 \u0432\u043e\u043a\u0440\u0443\u0433 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u0430 (Swagger UI, Swagger Editor \u0438 \u043f\u0440\u043e\u0447\u0438\u0435), \u0430 \u0441\u0430\u043c \u0444\u043e\u0440\u043c\u0430\u0442 \u043d\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f OpenAPI Specification.\u0422\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438 \u044d\u0442\u043e \u043e\u0434\u0438\u043d \u0444\u0430\u0439\u043b (\u043e\u0431\u044b\u0447\u043d\u043e YAML, \u0440\u0435\u0436\u0435 JSON), \u0432 \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u0432\u0441\u0451, \u0447\u0442\u043e \u043d\u0443\u0436\u043d\u043e \u0437\u043d\u0430\u0442\u044c \u043e REST API: \u043a\u0430\u043a\u0438\u0435 \u0435\u0441\u0442\u044c \u043f\u0443\u0442\u0438 (endpoints), \u043a\u0430\u043a\u0438\u0435 \u0443 \u043d\u0438\u0445 \u043c\u0435\u0442\u043e\u0434\u044b, \u043a\u0430\u043a\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0438 \u0442\u0435\u043b\u0430 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u043e\u043d\u0438 \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u044e\u0442, \u043a\u0430\u043a\u0438\u0435 \u043a\u043e\u0434\u044b \u043e\u0442\u0432\u0435\u0442\u043e\u0432 \u0438 \u043a\u0430\u043a\u0438\u0435 \u0441\u0445\u0435\u043c\u044b \u0434\u0430\u043d\u043d\u044b\u0445 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044e\u0442, \u043a\u0430\u043a \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u0430 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f. \u0413\u043b\u0430\u0432\u043d\u043e\u0435 \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u0444\u043e\u0440\u043c\u0430\u0442, \u0430 \u0438\u0434\u0435\u044f: \u043e\u0434\u0438\u043d \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u043e \u0447\u0438\u0442\u0430\u044e\u0442 \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a, \u0438 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b.\u0412\u043e\u0442 \u043a\u0430\u043a \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u0440\u043e\u0441\u0442\u043e\u0433\u043e endpoint \u2014 \u0441\u0435\u0440\u0432\u0438\u0441, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0437\u0430\u0434\u0430\u0447\u0443 \u043f\u043e \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u0443:openapi: 3.1.0info:  title: TODO Service  version: 1.0.0paths:  \/tasks\/{taskId}:    get:      operationId: getTask      summary: \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0437\u0430\u0434\u0430\u0447\u0443 \u043f\u043e \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u0443      parameters:        — name: taskId          in: path          required: true          schema:            type: string      responses:        ‘200’:          description: \u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0430\u0439\u0434\u0435\u043d\u0430          content:            application\/json:              schema:                $ref: ‘#\/components\/schemas\/Task’        ‘404’:          description: \u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u0430components:  schemas:    Task:      type: object      required: [id, title, done]      properties:        id:          type: string        title:          type: string        done:          type: boolean\u042d\u0442\u043e \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044f \u043f\u0440\u0430\u043a\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0431\u0435\u0437 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0438: \u0435\u0441\u0442\u044c \u043f\u0443\u0442\u044c\u00a0\/tasks\/{taskId}, \u043e\u043d \u043f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0432 \u043f\u0443\u0442\u0438, \u043e\u0442\u0434\u0430\u0451\u0442 \u043b\u0438\u0431\u043e\u00a0200\u00a0\u0441 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c\u00a0Task, \u043b\u0438\u0431\u043e\u00a0404. \u0418 \u2014 \u043a\u043b\u044e\u0447\u0435\u0432\u043e\u0439 \u043c\u043e\u043c\u0435\u043d\u0442 \u2014 \u044d\u0442\u043e\u0442 \u0436\u0435 \u0441\u0430\u043c\u044b\u0439 \u0442\u0435\u043a\u0441\u0442 \u0447\u0438\u0442\u0430\u044e\u0442 \u0438 \u0447\u0435\u043b\u043e\u0432\u0435\u043a, \u0438 \u043c\u0430\u0448\u0438\u043d\u0430: \u0442\u043e, \u0447\u0442\u043e \u0432\u044b \u0441\u0435\u0439\u0447\u0430\u0441 \u0440\u0430\u0437\u043e\u0431\u0440\u0430\u043b\u0438 \u0433\u043b\u0430\u0437\u0430\u043c\u0438 \u0431\u0435\u0437 \u043f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0438, \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0435\u0442 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u043d\u043e. \u041e\u0434\u0438\u043d \u0444\u0430\u0439\u043b, \u043e\u0434\u043d\u0430 \u043f\u0440\u0430\u0432\u0434\u0430 \u2014 \u0438 \u0434\u043b\u044f \u043b\u044e\u0434\u0435\u0439, \u0438 \u0434\u043b\u044f \u043a\u043e\u0434\u0430.\u041f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u0432\u043c\u0435\u0441\u0442\u043e \u043a\u043e\u043f\u0438\u043f\u0430\u0441\u0442\u044b: DRY \u0432 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0438 API\u041f\u0440\u0435\u0436\u0434\u0435 \u0447\u0435\u043c \u0438\u0434\u0442\u0438 \u0434\u0430\u043b\u044c\u0448\u0435, \u0441\u0442\u043e\u0438\u0442 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e \u043f\u043e\u043a\u0430\u0437\u0430\u0442\u044c \u0441\u0432\u043e\u0439\u0441\u0442\u0432\u043e, \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u0432 \u0440\u0443\u0447\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043f\u043e\u0447\u0442\u0438 \u043d\u0435\u0434\u043e\u0441\u0442\u0438\u0436\u0438\u043c\u043e, \u0430 \u0432 OpenAPI \u0434\u0430\u0451\u0442\u0441\u044f \u0434\u0430\u0440\u043e\u043c: \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435. \u042d\u0442\u043e, \u043d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u043e\u0434\u0438\u043d \u0438\u0437 \u0441\u0430\u043c\u044b\u0445 \u043d\u0435\u0434\u043e\u043e\u0446\u0435\u043d\u0451\u043d\u043d\u044b\u0445 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u043e\u0432, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043e\u0441\u0442\u0430\u043d\u043e\u0432\u043b\u044e\u0441\u044c \u043d\u0430 \u043d\u0451\u043c \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e.\u0421\u0445\u0435\u043c\u044b \u0434\u0430\u043d\u043d\u044b\u0445 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437.\u00a0\u0412 \u0432\u0438\u043a\u0438-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u043e\u0434\u043d\u0430 \u0438 \u0442\u0430 \u0436\u0435 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 (\u0441\u043a\u0430\u0436\u0435\u043c, \u043e\u0431\u044a\u0435\u043a\u0442 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0438\u043b\u0438 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u0430\u044f \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0442\u0432\u0435\u0442\u0430) \u0440\u0430\u0441\u043f\u043e\u043b\u0437\u0430\u0435\u0442\u0441\u044f \u043f\u043e \u0434\u0435\u0441\u044f\u0442\u043a\u0430\u043c endpoints, \u0438 \u043a\u0430\u0436\u0434\u043e\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0436\u0438\u0432\u0451\u0442 \u0441\u0432\u043e\u0435\u0439 \u0436\u0438\u0437\u043d\u044c\u044e. \u041a\u0442\u043e-\u0442\u043e \u043f\u043e\u043f\u0440\u0430\u0432\u0438\u043b \u043f\u043e\u043b\u0435 \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u0438 \u0437\u0430\u0431\u044b\u043b \u0432 \u043f\u044f\u0442\u0438 \u0434\u0440\u0443\u0433\u0438\u0445 \u2014 \u0438 \u0432\u043e\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0443\u0436\u0435 \u043f\u0440\u043e\u0442\u0438\u0432\u043e\u0440\u0435\u0447\u0438\u0442 \u0441\u0430\u043c\u0430 \u0441\u0435\u0431\u0435. \u0412 OpenAPI \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0435\u0434\u0438\u043d\u043e\u0436\u0434\u044b \u0432\u00a0components\/schemas, \u0430 \u0432\u0435\u0437\u0434\u0435 \u0434\u0430\u043b\u044c\u0448\u0435 \u043f\u043e\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437\u00a0$ref. \u041f\u043e\u043f\u0440\u0430\u0432\u0438\u043b\u0438 \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u2014 \u0438\u0437\u043c\u0435\u043d\u0438\u043b\u043e\u0441\u044c \u0432\u0435\u0437\u0434\u0435. \u0420\u0430\u0441\u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u0438\u0435 \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u0430\u043c\u043e\u0433\u043e \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u0430 \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0441\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043d\u043e \u043d\u0435\u0432\u043e\u0437\u043c\u043e\u0436\u043d\u044b\u043c.\u0420\u0430\u0437\u043d\u044b\u0435 \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u044b \u043e\u0442\u0432\u0435\u0442\u043e\u0432 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442\u0441\u044f \u043a\u0440\u0430\u0442\u043a\u043e \u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442 \u043e\u0431\u0449\u0435\u0435.\u00a0Endpoint \u0440\u0435\u0434\u043a\u043e \u043e\u0442\u0434\u0430\u0451\u0442 \u043e\u0434\u0438\u043d-\u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0439 \u0432\u0438\u0434 \u043e\u0442\u0432\u0435\u0442\u0430: \u0435\u0441\u0442\u044c\u00a0200, \u0435\u0441\u0442\u044c\u00a0400,\u00a0404,\u00a0409, \u0438 \u0443 \u043e\u0448\u0438\u0431\u043e\u043a \u043e\u0431\u044b\u0447\u043d\u043e \u043e\u0431\u0449\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430. \u0412 \u0440\u0443\u0447\u043d\u043e\u043c \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0438 \u044d\u0442\u043e \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u043f\u043e\u0440\u0442\u044f\u043d\u043a\u0443, \u0433\u0434\u0435 \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0442\u0432\u0435\u0442\u0430 \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u043d\u0430 \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043a\u043e\u0434\u0430 \u0437\u0430\u043d\u043e\u0432\u043e. \u0412 OpenAPI \u0432\u0441\u0435 \u043e\u0448\u0438\u0431\u043e\u0447\u043d\u044b\u0435 \u043e\u0442\u0432\u0435\u0442\u044b \u0441\u0441\u044b\u043b\u0430\u044e\u0442\u0441\u044f \u043d\u0430 \u043e\u0434\u043d\u0443 \u0441\u0445\u0435\u043c\u0443, \u0430 \u0434\u043b\u044f \u00ab\u0432\u0441\u0435\u0445 \u043f\u0440\u043e\u0447\u0438\u0445 \u043a\u043e\u0434\u043e\u0432\u00bb \u0435\u0441\u0442\u044c\u00a0default. \u041f\u043b\u044e\u0441 \u043d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435 \u0441\u0445\u0435\u043c \u0447\u0435\u0440\u0435\u0437\u00a0allOf: \u043e\u0431\u0449\u0443\u044e \u0447\u0430\u0441\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u0440\u043e\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0445 \u0442\u0438\u043f\u043e\u0432 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442 \u043e\u0434\u0438\u043d \u0440\u0430\u0437, \u0430 \u0447\u0430\u0441\u0442\u043d\u044b\u0435 \u0441\u043b\u0443\u0447\u0430\u0438 \u0435\u0451 \u043d\u0430\u0441\u043b\u0435\u0434\u0443\u044e\u0442 \u2014 \u0442\u043e\u0442 \u0441\u0430\u043c\u044b\u0439 DRY \u043d\u0430 \u0443\u0440\u043e\u0432\u043d\u0435 \u0434\u0430\u043d\u043d\u044b\u0445. \u0412\u0430\u0436\u043d\u0430\u044f \u043e\u0433\u043e\u0432\u043e\u0440\u043a\u0430 \u043d\u0430 \u0431\u0443\u0434\u0443\u0449\u0435\u0435:\u00a0allOf\u00a0\u2014 \u044d\u0442\u043e \u0438\u043c\u0435\u043d\u043d\u043e \u043d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435, \u0430 \u043d\u0435 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u0438\u0437\u043c, \u0438 \u044d\u0442\u043e \u0441\u043f\u043e\u043a\u043e\u0439\u043d\u044b\u0439, \u043f\u0440\u0435\u0434\u0441\u043a\u0430\u0437\u0443\u0435\u043c\u044b\u0439 \u0441\u043b\u0443\u0447\u0430\u0439 \u2014 \u043e\u043d \u0438 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u044d\u043b\u0435\u0433\u0430\u043d\u0442\u043d\u043e, \u0438 \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0435\u0442\u0441\u044f \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440\u0430\u043c\u0438 \u0432 \u043a\u043e\u0434 \u0431\u0435\u0437 \u0441\u044e\u0440\u043f\u0440\u0438\u0437\u043e\u0432. \u0421 \u043f\u043e\u043b\u0438\u043c\u043e\u0440\u0444\u043d\u044b\u043c\u0438 union-\u0442\u0438\u043f\u0430\u043c\u0438 (oneOf\/anyOf) \u0434\u0435\u043b\u043e \u043e\u0431\u0441\u0442\u043e\u0438\u0442 \u0438\u043d\u0430\u0447\u0435, \u043d\u043e \u043e \u043d\u0438\u0445 \u0440\u0435\u0447\u044c \u043f\u043e\u0439\u0434\u0451\u0442 \u0432 \u0440\u0430\u0437\u0434\u0435\u043b\u0435 \u043f\u0440\u043e \u043d\u0435\u0434\u043e\u0441\u0442\u0430\u0442\u043a\u0438.\u041f\u0440\u0438\u043c\u0435\u0440\u044b \u0442\u043e\u0436\u0435 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442\u0441\u044f.\u00a0\u0425\u043e\u0440\u043e\u0448\u043e \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u043e\u0442\u0432\u0435\u0442\u0430 (examples) \u043c\u043e\u0436\u043d\u043e \u0432\u044b\u043d\u0435\u0441\u0442\u0438 \u0432\u00a0components\u00a0\u0438 \u0441\u0441\u044b\u043b\u0430\u0442\u044c\u0441\u044f \u043d\u0430 \u043d\u0435\u0433\u043e \u043e\u0442\u043e\u0432\u0441\u044e\u0434\u0443, \u0433\u0434\u0435 \u043e\u043d \u0443\u043c\u0435\u0441\u0442\u0435\u043d \u2014 \u0438\u0437 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u0438\u0437 mock-\u0441\u0435\u0440\u0432\u0435\u0440\u0430, \u0438\u0437 \u0442\u0435\u0441\u0442\u043e\u0432. \u041e\u0434\u0438\u043d \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u044b\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0441\u0440\u0430\u0437\u0443 \u043d\u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043f\u043e\u0442\u0440\u0435\u0431\u0438\u0442\u0435\u043b\u0435\u0439, \u0430 \u043d\u0435 \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0432 \u043a\u0430\u0436\u0434\u043e\u043c.\u041f\u043e\u0441\u043c\u043e\u0442\u0440\u0438\u0442\u0435, \u043a\u0430\u043a \u043a\u043e\u043c\u043f\u0430\u043a\u0442\u043d\u043e \u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u043d\u0430 \u043f\u0440\u0430\u043a\u0442\u0438\u043a\u0435:yamlpaths:  \/tasks\/{taskId}:    get:      operationId: getTask      parameters:        — $ref: ‘#\/components\/parameters\/TaskId’   # \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u043e\u043f\u0438\u0441\u0430\u043d \u043e\u0434\u0438\u043d \u0440\u0430\u0437      responses:        ‘200’:          description: \u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0430\u0439\u0434\u0435\u043d\u0430          content:            application\/json:              schema:                $ref: ‘#\/components\/schemas\/Task’              examples:                sample:                  $ref: ‘#\/components\/examples\/TaskSample’  # \u043f\u0440\u0438\u043c\u0435\u0440 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f        ‘404’:          $ref: ‘#\/components\/responses\/NotFound’   # \u043e\u0431\u0449\u0438\u0439 \u043e\u0442\u0432\u0435\u0442 \u043e\u0431 \u043e\u0448\u0438\u0431\u043a\u0435        default:          $ref: ‘#\/components\/responses\/Error’       # \u0432\u0441\u0451 \u043f\u0440\u043e\u0447\u0435\u0435 \u2014 \u043e\u0434\u043d\u043e\u0439 \u0441\u0442\u0440\u043e\u043a\u043e\u0439components:  parameters:    TaskId:      name: taskId      in: path      required: true      schema:        type: string  responses:    NotFound:      description: \u041d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u043e      content:        application\/json:          schema:            $ref: ‘#\/components\/schemas\/Error’   # \u0442\u0430 \u0436\u0435 \u0441\u0445\u0435\u043c\u0430 \u043e\u0448\u0438\u0431\u043a\u0438    Error:      description: \u041e\u0448\u0438\u0431\u043a\u0430      content:        application\/json:          schema:            $ref: ‘#\/components\/schemas\/Error’  schemas:    Error:                       # \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0448\u0438\u0431\u043a\u0438 \u043e\u043f\u0438\u0441\u0430\u043d\u0430 \u0440\u043e\u0432\u043d\u043e \u043e\u0434\u0438\u043d \u0440\u0430\u0437      type: object      required: [code, message]      properties:        code:          type: integer        message:          type: string    Task:      allOf:                     # \u043d\u0430\u0441\u043b\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435: \u043e\u0431\u0449\u0435\u0435 \u043e\u043f\u0438\u0441\u0430\u043d\u043e \u043e\u0434\u0438\u043d \u0440\u0430\u0437        — $ref: ‘#\/components\/schemas\/Entity’        — type: object          required: [title, done]          properties:            title:              type: string            done:              type: boolean    Entity:                      # \u0431\u0430\u0437\u043e\u0432\u044b\u0435 \u043f\u043e\u043b\u044f, \u043e\u0431\u0449\u0438\u0435 \u0434\u043b\u044f \u043c\u043d\u043e\u0433\u0438\u0445 \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u0435\u0439      type: object      required: [id]      properties:        id:          type: string  examples:    TaskSample:      value:        id: «42»        title: «\u041a\u0443\u043f\u0438\u0442\u044c \u043c\u043e\u043b\u043e\u043a\u043e»        done: false\u0417\u0434\u0435\u0441\u044c \u043d\u0435\u0442 \u043d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u043e \u043e\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0433\u043e \u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u0430: \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440, \u0441\u0445\u0435\u043c\u0430 \u043e\u0448\u0438\u0431\u043a\u0438, \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043e\u0442\u0432\u0435\u0442\u0430, \u0431\u0430\u0437\u043e\u0432\u044b\u0435 \u043f\u043e\u043b\u044f \u0441\u0443\u0449\u043d\u043e\u0441\u0442\u0438 \u0438 \u043f\u0440\u0438\u043c\u0435\u0440 \u2014 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u0432 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u043c \u044d\u043a\u0437\u0435\u043c\u043f\u043b\u044f\u0440\u0435, \u0430 endpoints \u043d\u0430 \u043d\u0438\u0445 \u0441\u0441\u044b\u043b\u0430\u044e\u0442\u0441\u044f. \u0412 \u0440\u0443\u0447\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0440\u043e\u0432\u043d\u043e \u044d\u0442\u0438 \u0432\u0435\u0449\u0438 \u043a\u043e\u043f\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u0441\u043d\u043e\u0432\u0430 \u0438 \u0441\u043d\u043e\u0432\u0430 \u0438 \u0438\u043c\u0435\u043d\u043d\u043e \u0432 \u044d\u0442\u043e\u043c \u043a\u043e\u043f\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0438 \u0438 \u043d\u0430\u043a\u0430\u043f\u043b\u0438\u0432\u0430\u0435\u0442\u0441\u044f \u0440\u0430\u0441\u0441\u0438\u043d\u0445\u0440\u043e\u043d.\u0418 \u0435\u0449\u0451 \u043e\u0434\u043d\u043e \u2014 \u043d\u0430 \u0441\u043b\u0443\u0447\u0430\u0439 \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0451\u043d\u043d\u043e\u0433\u043e \u043f\u0440\u0435\u0434\u0443\u0431\u0435\u0436\u0434\u0435\u043d\u0438\u044f, \u0447\u0442\u043e \u00abREST \u2014 \u044d\u0442\u043e \u043f\u0440\u043e \u0441\u0442\u0430\u0440\u043e\u043c\u043e\u0434\u043d\u044b\u0435 \u00ab\u0437\u0430\u043f\u0440\u043e\u0441-\u043e\u0442\u0432\u0435\u0442\u00bb, \u0430 \u0432\u0441\u0451 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0435 \u043c\u0438\u043c\u043e\u201c\u00bb. \u042d\u0442\u043e \u043d\u0435 \u0442\u0430\u043a. \u0421\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 OpenAPI \u0443\u043c\u0435\u044e\u0442 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0438 \u043f\u043e\u0442\u043e\u043a\u043e\u0432\u044b\u0435 (streaming) \u043e\u0442\u0432\u0435\u0442\u044b \u2014 \u0442\u0435 \u0441\u0430\u043c\u044b\u0435, \u043f\u043e \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u043e\u0442\u0432\u0435\u0442 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u043d\u0435 \u043e\u0434\u043d\u0438\u043c \u043a\u0443\u0441\u043a\u043e\u043c, \u0430 \u043f\u043e\u0441\u0442\u0435\u043f\u0435\u043d\u043d\u043e, \u043f\u043e \u043c\u0435\u0440\u0435 \u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0438. \u0421\u0430\u043c\u044b\u0439 \u0443\u0437\u043d\u0430\u0432\u0430\u0435\u043c\u044b\u0439 \u0441\u0435\u0433\u043e\u0434\u043d\u044f \u043f\u0440\u0438\u043c\u0435\u0440 \u2014 \u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u0441 AI-\u0447\u0430\u0442-\u0431\u043e\u0442\u0430\u043c\u0438, \u0433\u0434\u0435 \u0442\u0435\u043a\u0441\u0442 \u00ab\u043f\u0435\u0447\u0430\u0442\u0430\u0435\u0442\u0441\u044f\u00bb \u043d\u0430 \u044d\u043a\u0440\u0430\u043d\u0435 \u043f\u043e \u043c\u0435\u0440\u0435 \u043f\u043e\u0441\u0442\u0443\u043f\u043b\u0435\u043d\u0438\u044f \u0442\u043e\u043a\u0435\u043d\u043e\u0432 (\u043a\u0430\u043a \u043f\u0440\u0430\u0432\u0438\u043b\u043e, \u0447\u0435\u0440\u0435\u0437 Server-Sent Events). \u0422\u0430\u043a\u0438\u0435 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b OpenAPI \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u043d\u0430\u0440\u0430\u0432\u043d\u0435 \u0441 \u043e\u0431\u044b\u0447\u043d\u044b\u043c\u0438, \u0430 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b \u0438\u0445 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442: \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0439 swift-openapi-generator \u0443\u043c\u0435\u0435\u0442 \u043e\u0442\u0434\u0430\u0432\u0430\u0442\u044c \u0442\u0435\u043b\u043e \u043f\u043e\u0442\u043e\u043a\u043e\u0432\u043e\u0433\u043e \u043e\u0442\u0432\u0435\u0442\u0430 \u043a\u0430\u043a\u00a0AsyncSequence\u00a0\u2014 \u0442\u043e \u0435\u0441\u0442\u044c \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442 \u0432\u044b\u0434\u0430\u0451\u0442 \u043f\u043e\u0442\u043e\u043a, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 Swift \u043e\u0431\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0440\u043e\u0434\u043d\u044b\u043c\u00a0for try await. \u0422\u0430\u043a \u0447\u0442\u043e \u043f\u043e\u0434\u0445\u043e\u0434 \u00ab\u0441\u043d\u0430\u0447\u0430\u043b\u0430 \u043a\u043e\u043d\u0442\u0440\u0430\u043a\u0442\u00bb \u043d\u0435 \u0437\u0430\u043f\u0438\u0440\u0430\u0435\u0442 \u0432\u0430\u0441 \u0432 \u043f\u0430\u0440\u0430\u0434\u0438\u0433\u043c\u0435 \u043f\u0440\u043e\u0448\u043b\u043e\u0433\u043e \u0434\u0435\u0441\u044f\u0442\u0438\u043b\u0435\u0442\u0438\u044f: \u043e\u043d \u043f\u043e\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u0438 \u0442\u043e, \u0447\u0442\u043e \u0432\u044b \u043f\u0438\u0448\u0435\u0442\u0435 \u043f\u0440\u044f\u043c\u043e \u0441\u0435\u0439\u0447\u0430\u0441, \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u0443\u044f…<\/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-482619","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/482619","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=482619"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/482619\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=482619"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=482619"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=482619"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}