{"id":8634,"date":"2022-11-21T10:56:44","date_gmt":"2022-11-21T02:56:44","guid":{"rendered":"http:\/\/123.57.164.21\/?p=8634"},"modified":"2022-11-21T10:56:44","modified_gmt":"2022-11-21T02:56:44","slug":"swagger%e5%8a%9f%e8%83%bd%e7%ae%80%e4%bb%8b","status":"publish","type":"post","link":"https:\/\/92it.top\/?p=8634","title":{"rendered":"Swagger\u529f\u80fd\u7b80\u4ecb"},"content":{"rendered":"\n<p>\u5468\u672b\u62bd\u4e86\u70b9\u65f6\u95f4\u628aSwagger\u770b\u4e86\u4e00\u4e0b\uff0c\u8fd9\u91cc\u5199\u7bc7\u6587\u7ae0\u5c0f\u7ed3\u4e00\u4e0b\u3002Swagger\u7684<a href=\"https:\/\/swagger.io\/tools\/swagger-ui\/\">\u5b98\u7f51<\/a>\u4e0a\u6709\u4e00\u4e2a\u5728\u7ebf\u7684demo\uff0c\u53ef\u4ee5\u5728\u7ebf\u4f53\u9a8c\u3002\u6211\u4eec\u4e5f\u53ef\u4ee5\u4e0b\u8f7d\u5176<a href=\"https:\/\/github.com\/swagger-api\/swagger-ui\">\u6e90\u7801<\/a>\uff0c\u6267\u884cdist\\index.html\u6587\u4ef6\uff0c\u5373\u53ef\u5f97\u5230\u548c\u5b98\u7f51\u4e00\u6837\u529f\u80fd\u7684demo\uff0c\u4e0d\u9700\u8981\u67b6\u8bbe\u670d\u52a1\u5668\u5c31\u80fd\u4f7f\u7528\u3002<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/123.57.164.21\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-1024x376.png\" alt=\"\" class=\"wp-image-8635\" width=\"481\" height=\"176\" srcset=\"https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-1024x376.png 1024w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-300x110.png 300w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-768x282.png 768w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-830x305.png 830w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-230x84.png 230w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-350x129.png 350w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239-480x176.png 480w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-239.png 1040w\" sizes=\"(max-width: 481px) 100vw, 481px\" \/><\/figure><\/div>\n\n\n\n<p>\u4ece\u7f51\u7edc\u8bf7\u6c42\u4e2d\u67e5\u770b\uff0c\u53d1\u73b0\u5b83\u8bf7\u6c42\u4e86\u4e00\u4e2a\u540d\u4e3aswagger.json\u7684\u6587\u4ef6\u3002\u00a0\u00a0\u00a0\u00a0<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/123.57.164.21\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-240.png\" alt=\"\" class=\"wp-image-8636\" width=\"366\" height=\"234\" srcset=\"https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-240.png 732w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-240-300x192.png 300w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-240-230x147.png 230w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-240-350x224.png 350w, https:\/\/92it.top\/wp-content\/uploads\/2022\/11\/\u56fe\u7247-240-480x307.png 480w\" sizes=\"(max-width: 366px) 100vw, 366px\" \/><\/figure><\/div>\n\n\n\n<p>\u800c\u8fd9\u4e2ajson\u6587\u4ef6\u91cc\u9762\u5b9a\u4e49\u7684\u57fa\u672c\u5c31\u662f\u6587\u6863\u7684schema\u3002\u4ece\u8fd9\u4e2a\u9875\u9762\u6211\u4eec\u57fa\u672c\u4e0a\u53ef\u4ee5\u53d1\u73b0swagger\u7684\u539f\u7406\u4e86\uff1a<\/p>\n\n\n\n<ul><li>swagger\u4f9d\u8d56\u4e00\u4e2a\u57fa\u4e8eopenapi\u89c4\u8303\u7684json\u6587\u6863\uff0c\u5b83\u5b9a\u4e49\u4e86\u63a5\u53e3schema\u3002<\/li><li>\u9875\u9762\u52a0\u8f7d\u540e\uff0c\u4f1a\u83b7\u53d6\u6307\u5b9a\u7684\u63a5\u53e3\u7684schema\uff0c\u7136\u540e\u751f\u6210\u63a5\u53e3\u9875\u9762\u3002<\/li><li>\u70b9\u51fb\u6267\u884c\u540e\uff0c\u4f1a\u901a\u8fc7\u6d4f\u89c8\u5668\u53d1\u9001ajax\u8bf7\u6c42\uff0c\u7136\u540e\u5c06\u7ed3\u679c\u5448\u73b0\u5728\u754c\u9762\u4e0a\uff0c\u4ece\u800c\u5b9e\u73b0\u63a5\u53e3\u6d4b\u8bd5\u3002<\/li><\/ul>\n\n\n\n<p>\u7b80\u5355\u7684\u6765\u8bb2\uff0cswagger\u63a5\u53e3\u6d4b\u8bd5\u662f\u4e00\u4e2a\u7eaf\u524d\u7aef\u7684\u5b9e\u73b0\uff0c\u4e0d\u9700\u8981\u540e\u53f0\u652f\u6301\u3002\u5b83\u5c31\u662f\u4e00\u4e2a\u5728\u7ebf\u7248\u7684postman\uff0c\u5b9e\u9645\u4e0a\uff0cpostman\u4e5f\u652f\u6301openapi\u89c4\u8303\uff0c\u901a\u8fc7\u5bfc\u5165scheme\u540e\uff0c\u4e5f\u53ef\u4ee5\u5b9e\u73b0\u4e00\u6837\u7684\u529f\u80fd\u3002\u4e0d\u8fc7\uff0c\u548cpostman\u76f8\u6bd4\uff0cswagger\u5177\u6709\u5982\u4e0b\u4f18\u52bf\uff1a<\/p>\n\n\n\n<ul><li>\u4e0d\u9700\u8981\u672c\u5730\u5ba2\u6237\u7aef<\/li><li>\u53ef\u4ee5\u548c\u5e94\u7528\u96c6\u6210\uff0c\u4e0d\u9700\u8981\u624b\u52a8\u5bfc\u5165\u63a5\u53e3\u5b9a\u4e49<\/li><li>\u901a\u8fc7\u6d4f\u89c8\u5668\u53d1\u9001\u7684ajax\u8bf7\u6c42\uff0c\u5f80\u5f80\u53ef\u81ea\u52a8\u57fa\u7840\u4e86\u7528\u6237\u7684\u8eab\u4efd\u4fe1\u606f\uff0c\u6d4b\u8bd5\u5e26\u6743\u9650\u63a7\u5236\u7684\u63a5\u53e3\u975e\u5e38\u65b9\u4fbf\u3002<\/li><\/ul>\n\n\n\n<p>\u5728.net core\u4e2d\uff0c\u8981\u5c06swaggerui\u548c\u7ad9\u70b9\u96c6\u6210\uff0c\u9700\u8981\u8fdb\u884c\u5982\u4e0b\u51e0\u6b65\uff1a<\/p>\n\n\n\n<ul><li>\u6839\u636eApiExplore\u751f\u6210\u63a5\u53e3\u6587\u6863\u5185\u5bb9<\/li><li>\u6ce8\u518c\u8def\u7531\uff0c\u63d0\u4f9b\u63a5\u53e3\u6587\u6863\u7684\u4e0b\u8f7d\u5730\u5740<\/li><li>\u5c06swaggerui\u9875\u9762\u96c6\u6210\u5230\u7ad9\u70b9\u4e2d<\/li><li>\u5c06\u8def\u7531\u8def\u5f84\u8bbe\u7f6e\u5230swagger\u9875\u9762\u4e2d<\/li><\/ul>\n\n\n\n<p>\u7b80\u5355\u7684\u6765\u8bb2\u5c31\u4e24\u6b65\uff0c\u63d0\u4f9b\u63a5\u53e3\u6587\u6863\u4e0b\u8f7durl\u548c\u96c6\u6210swaggerui\u3002\u5f53\u524d.net core\u5df2\u7ecf\u6709\u4e86\u4e00\u4e9b\u5f00\u6e90\u5b9e\u73b0\uff0c\u5982\uff1a<a href=\"https:\/\/docs.microsoft.com\/en-us\/aspnet\/core\/tutorials\/getting-started-with-swashbuckle\">swashbuckle<\/a>\u548c<a href=\"https:\/\/docs.microsoft.com\/en-us\/aspnet\/core\/tutorials\/getting-started-with-nswag\">nswag<\/a>\u3002\u5bf9\u4e8e\u5927\u591a\u6570\u7684\u573a\u666f\u6765\u8bf4\uff0c\u76f4\u63a5\u4f7f\u7528\u5b83\u4eec\u662f\u975e\u5e38\u65b9\u4fbf\u7684\u3002<\/p>\n\n\n\n<p>\u7136\u800c\uff0c\u6709\u7684\u65f6\u5019\u6211\u4eec\u662f\u9700\u8981\u4e00\u4e9b\u9ad8\u7ea7\u7684\u529f\u80fd\u7684\uff0c\u5982\u5206\u5e03\u5f0f\u7684\u670d\u52a1\u9700\u8981\u63d0\u4f9b\u4e00\u4e2a\u96c6\u4e2d\u7684api\u9875\u9762\uff0c\u6216\u8005\u9700\u8981\u5bf9\u9875\u9762\u8fdb\u884c\u4e00\u4e9b\u5b9a\u5236\uff08\u5982\u5206\u7ec4\uff0c\u6743\u9650\u63a7\u5236\uff0c\u6837\u5f0f\u8c03\u6574\u7b49\uff09\u3002\u867d\u7136\u8fd9\u4e9b\u5e93\u4e5f\u63d0\u4f9b\u4e86\u4e00\u5b9a\u7684\u652f\u6301\uff0c\u4f46\u5f80\u5f80\u4e0d\u591f\u7075\u6d3b\u3002\u4e00\u4e2a\u7b80\u5355\u7684\u65b9\u6848\u662f\uff1a\u53ea\u5229\u7528\u8fd9\u4e9b\u5e93\u6765\u751f\u6210swagger\u63a5\u53e3\u6587\u6863swagger.json\uff0c\u5728\u5b98\u65b9\u7684\u9759\u6001\u9875\u9762\u57fa\u7840\u4e0a\u81ea\u5df1\u5b9a\u5236UI\uff0c\u8fd9\u6837\u8981\u7075\u6d3b\u7684\u591a\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5468\u672b\u62bd\u4e86\u70b9\u65f6\u95f4\u628aSwagger\u770b\u4e86\u4e00\u4e0b\uff0c\u8fd9\u91cc\u5199\u7bc7\u6587\u7ae0\u5c0f\u7ed3\u4e00\u4e0b\u3002Swagger\u7684\u5b98\u7f51\u4e0a\u6709\u4e00\u4e2a\u5728\u7ebf\u7684demo\uff0c\u53ef\u4ee5 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[26],"tags":[],"_links":{"self":[{"href":"https:\/\/92it.top\/index.php?rest_route=\/wp\/v2\/posts\/8634"}],"collection":[{"href":"https:\/\/92it.top\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/92it.top\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/92it.top\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/92it.top\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=8634"}],"version-history":[{"count":2,"href":"https:\/\/92it.top\/index.php?rest_route=\/wp\/v2\/posts\/8634\/revisions"}],"predecessor-version":[{"id":8638,"href":"https:\/\/92it.top\/index.php?rest_route=\/wp\/v2\/posts\/8634\/revisions\/8638"}],"wp:attachment":[{"href":"https:\/\/92it.top\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=8634"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/92it.top\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=8634"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/92it.top\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=8634"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}