{"id":206548,"date":"2025-06-12T10:56:50","date_gmt":"2025-06-12T02:56:50","guid":{"rendered":"https:\/\/server.hk\/cnblog\/206548\/"},"modified":"2025-06-12T10:56:50","modified_gmt":"2025-06-12T02:56:50","slug":"%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8go-swagge%e8%a7%a3%e5%86%b3api%e6%96%87%e6%a1%a3%e5%ad%97%e6%ae%b5%e5%bf%85%e5%a1%ab%e9%97%ae%e9%a2%98%ef%bc%9f","status":"publish","type":"post","link":"https:\/\/server.hk\/cnblog\/206548\/","title":{"rendered":"\u5982\u4f55\u4f7f\u7528Go Swagge\u89e3\u51b3API\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f"},"content":{"rendered":"<p>\u54c8\u55bd\uff01\u5927\u5bb6\u597d\uff0c\u5f88\u9ad8\u5174\u53c8\u89c1\u9762\u4e86\uff0c\u6211\u662fGOLANG\u7684\u4e00\u540d\u4f5c\u8005\uff0c\u4eca\u5929\u7531\u6211\u7ed9\u5927\u5bb6\u5e26\u6765\u4e00\u7bc7<br \/>\n<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\">\u300a\u5982\u4f55\u4f7f\u7528Go Swagge\u89e3\u51b3API\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f\u300b<\/span>\uff0c\u672c\u6587\u4e3b\u8981\u4f1a\u8bb2\u5230<br \/>\n<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\"><\/span>\u7b49\u7b49\u77e5\u8bc6\u70b9\uff0c\u5e0c\u671b\u5927\u5bb6\u4e00\u8d77\u5b66\u4e60\u8fdb\u6b65\uff0c\u4e5f\u6b22\u8fce\u5927\u5bb6\u5173\u6ce8\u3001\u70b9\u8d5e\u3001\u6536\u85cf\u3001\u8f6c\u53d1! \u4e0b\u9762\u5c31\u4e00\u8d77\u6765\u770b\u770b\u5427\uff01,<br \/>\n<img decoding=\"async\" src=\"https:\/\/www.17golang.com\/uploads\/20241115\/17316331536736a00172ca2.jpg\" class=\"aligncenter\">,<br \/>\n<strong>go swagge\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f<\/strong>,<br \/>\n<strong>\u5185\u5bb9<\/strong>,\u5e0c\u671b\u4f7f\u7528go swagge\u751f\u6210api\u6587\u6863\uff0c\u4f46\u9047\u5230\u4ee5\u4e0b\u95ee\u9898\uff1a,<br \/>\n<strong>\u89e3\u51b3\u65b9\u6848<\/strong>,<br \/>\n<strong>1. \u786e\u8ba4\u4ee3\u7801\u6b63\u786e<\/strong>,\u786e\u4fdd\u4ee3\u7801\u4e2d\u5df2\u6b63\u786e\u4f7f\u7528\u9a8c\u8bc1\u6807\u8bb0\uff0c\u4f8b\u5982\uff1a,<br \/>\n<strong>2. \u4f7f\u7528\u5b98\u65b9\u5de5\u5177<\/strong>,\u5efa\u8bae\u4f7f\u7528go\u5b98\u65b9\u63d0\u4f9b\u7684swagger editor\u751f\u6210api\u6587\u6863\u3002,<br \/>\n<strong>\u4f18\u70b9<\/strong>,<br \/>\n<strong>\u4f7f\u7528\u6b65\u9aa4<\/strong>,\u5b8c\u6210\u4ee5\u4e0a\u6b65\u9aa4\uff0c\u5373\u53ef\u751f\u6210\u5305\u542b\u6240\u6709\u5fc5\u9700\u5b57\u6bb5\u63cf\u8ff0\u7684swagger\u6587\u6863\u3002,\u4eca\u5929\u5e26\u5927\u5bb6\u4e86\u89e3\u4e86\u7684\u76f8\u5173\u77e5\u8bc6\uff0c\u5e0c\u671b\u5bf9\u4f60\u6709\u6240\u5e2e\u52a9\uff1b\u5173\u4e8eGOLANG\u7684\u6280\u672f\u77e5\u8bc6\u6211\u4eec\u4f1a\u4e00\u70b9\u70b9\u6df1\u5165\u4ecb\u7ecd\uff0c\u6b22\u8fce\u5927\u5bb6\u5173\u6ce8GOLANG\u516c\u4f17\u53f7\uff0c\u4e00\u8d77\u5b66\u4e60\u7f16\u7a0b~,\u6548\u7387\u9ad8\uff0c\u8bed\u6cd5\u7b80\u5355,\u624b\u52a8\u7f16\u5199\uff0c\u4e0d\u4f1a\u4fb5\u5165\u6e90\u4ee3\u7801,\u652f\u6301openapi 3.0\u548c3.1,\u5b98\u65b9\u5de5\u5177\uff0c\u66f4\u65b0\u901f\u5ea6\u5feb,\u6ce8\u91ca\u4e2d\u5df2\u6807\u8bb0\u5fc5\u586b\uff0c\u6587\u6863\u4e2d\u5374\u672a\u663e\u793a\u7ea2\u8272\u661f\u53f7,\u6587\u6863\u4e2d\u5b57\u6bb5\u5fc5\u586b\u9009\u9879\u9700\u8981\u624b\u52a8\u70b9\u5f00\u624d\u80fd\u67e5\u770b,go swagge\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f,\u54c8\u55bd\uff01\u5927\u5bb6\u597d\uff0c\u5f88\u9ad8\u5174\u53c8\u89c1\u9762\u4e86\uff0c\u6211\u662fGOLANG\u7684\u4e00\u540d\u4f5c\u8005\uff0c\u4eca\u5929\u7531\u6211\u7ed9\u5927\u5bb6\u5e26\u6765\u4e00\u7bc7<br \/>\n<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\">\u300a\u5982\u4f55\u4f7f\u7528Go Swagge\u89e3\u51b3API\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f\u300b<\/span>\uff0c\u672c\u6587\u4e3b\u8981\u4f1a\u8bb2\u5230<br \/>\n<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\"><\/span>\u7b49\u7b49\u77e5\u8bc6\u70b9\uff0c\u5e0c\u671b\u5927\u5bb6\u4e00\u8d77\u5b66\u4e60\u8fdb\u6b65\uff0c\u4e5f\u6b22\u8fce\u5927\u5bb6\u5173\u6ce8\u3001\u70b9\u8d5e\u3001\u6536\u85cf\u3001\u8f6c\u53d1! \u4e0b\u9762\u5c31\u4e00\u8d77\u6765\u770b\u770b\u5427\uff01,<br \/>\n<b><\/b> <\/p>\n<p>\u5f53\u524d\u4f4d\u7f6e\uff1a <span>&gt;<\/span>  <span>&gt;<\/span>  <span>&gt;<\/span>  <span>&gt;<\/span> <span>\u5982\u4f55\u4f7f\u7528Go Swagge\u89e3\u51b3API\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f<\/span><\/p>\n<h1>\u5982\u4f55\u4f7f\u7528Go Swagge\u89e3\u51b3API\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f<\/h1>\n<p><span>2024-11-15 09:12:48<\/span><br \/>\n<span><i><\/i>0\u6d4f\u89c8<\/span><br \/>\n<span style=\"cursor: pointer\"><i><\/i>\u6536\u85cf<\/span> <\/p>\n<p>\u54c8\u55bd\uff01\u5927\u5bb6\u597d\uff0c\u5f88\u9ad8\u5174\u53c8\u89c1\u9762\u4e86\uff0c\u6211\u662fGOLANG\u7684\u4e00\u540d\u4f5c\u8005\uff0c\u4eca\u5929\u7531\u6211\u7ed9\u5927\u5bb6\u5e26\u6765\u4e00\u7bc7<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\">\u300a\u5982\u4f55\u4f7f\u7528Go Swagge\u89e3\u51b3API\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f\u300b<\/span>\uff0c\u672c\u6587\u4e3b\u8981\u4f1a\u8bb2\u5230<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\"><\/span>\u7b49\u7b49\u77e5\u8bc6\u70b9\uff0c\u5e0c\u671b\u5927\u5bb6\u4e00\u8d77\u5b66\u4e60\u8fdb\u6b65\uff0c\u4e5f\u6b22\u8fce\u5927\u5bb6\u5173\u6ce8\u3001\u70b9\u8d5e\u3001\u6536\u85cf\u3001\u8f6c\u53d1! \u4e0b\u9762\u5c31\u4e00\u8d77\u6765\u770b\u770b\u5427\uff01<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.17golang.com\/uploads\/20241115\/17316331536736a00172ca2.jpg\" class=\"aligncenter\"><\/p>\n<p><strong>go swagge\u6587\u6863\u5b57\u6bb5\u5fc5\u586b\u95ee\u9898\uff1f<\/strong><\/p>\n<p><strong>\u5185\u5bb9<\/strong><\/p>\n<p>\u5e0c\u671b\u4f7f\u7528go swagge\u751f\u6210api\u6587\u6863\uff0c\u4f46\u9047\u5230\u4ee5\u4e0b\u95ee\u9898\uff1a<\/p>\n<ul>\n<li>\u6587\u6863\u4e2d\u5b57\u6bb5\u5fc5\u586b\u9009\u9879\u9700\u8981\u624b\u52a8\u70b9\u5f00\u624d\u80fd\u67e5\u770b<\/li>\n<li>\u6ce8\u91ca\u4e2d\u5df2\u6807\u8bb0\u5fc5\u586b\uff0c\u6587\u6863\u4e2d\u5374\u672a\u663e\u793a\u7ea2\u8272\u661f\u53f7<\/li>\n<\/ul>\n<p><strong>\u89e3\u51b3\u65b9\u6848<\/strong><\/p>\n<p><strong>1. \u786e\u8ba4\u4ee3\u7801\u6b63\u786e<\/strong><\/p>\n<p>\u786e\u4fdd\u4ee3\u7801\u4e2d\u5df2\u6b63\u786e\u4f7f\u7528\u9a8c\u8bc1\u6807\u8bb0\uff0c\u4f8b\u5982\uff1a<\/p>\n<pre>\/\/ RegionId \u5730\u533aID        | \u5fc5\u586b\nRegionId string `json:\"region_id\" valid:\"Required\"`<\/pre>\n<p><strong>2. \u4f7f\u7528\u5b98\u65b9\u5de5\u5177<\/strong><\/p>\n<p>\u5efa\u8bae\u4f7f\u7528go\u5b98\u65b9\u63d0\u4f9b\u7684swagger editor\u751f\u6210api\u6587\u6863\u3002<\/p>\n<p><strong>\u4f18\u70b9<\/strong><\/p>\n<ul>\n<li>\u5b98\u65b9\u5de5\u5177\uff0c\u66f4\u65b0\u901f\u5ea6\u5feb<\/li>\n<li>\u652f\u6301openapi 3.0\u548c3.1<\/li>\n<li>\u624b\u52a8\u7f16\u5199\uff0c\u4e0d\u4f1a\u4fb5\u5165\u6e90\u4ee3\u7801<\/li>\n<li>\u6548\u7387\u9ad8\uff0c\u8bed\u6cd5\u7b80\u5355<\/li>\n<\/ul>\n<p><strong>\u4f7f\u7528\u6b65\u9aa4<\/strong><\/p>\n<ul>\n<li>\u6253\u5f00swagger editor (https:\/\/editor.swagger.io\/)<\/li>\n<li>\u521b\u5efa\u65b0\u6587\u6863<\/li>\n<li>\u5728\u201cpaths\u201d\u4e2d\u6dfb\u52a0\u8def\u5f84\u548c\u64cd\u4f5c<\/li>\n<li>\u5728\u201cparameters\u201d\u4e2d\u6dfb\u52a0\u8bf7\u6c42\u53c2\u6570<\/li>\n<li>\u5728\u201cschema\u201d\u4e2d\u5b9a\u4e49\u5bf9\u8c61\u6a21\u578b<\/li>\n<\/ul>\n<p>\u5b8c\u6210\u4ee5\u4e0a\u6b65\u9aa4\uff0c\u5373\u53ef\u751f\u6210\u5305\u542b\u6240\u6709\u5fc5\u9700\u5b57\u6bb5\u63cf\u8ff0\u7684swagger\u6587\u6863\u3002<\/p>\n<p>\u4eca\u5929\u5e26\u5927\u5bb6\u4e86\u89e3\u4e86\u7684\u76f8\u5173\u77e5\u8bc6\uff0c\u5e0c\u671b\u5bf9\u4f60\u6709\u6240\u5e2e\u52a9\uff1b\u5173\u4e8eGOLANG\u7684\u6280\u672f\u77e5\u8bc6\u6211\u4eec\u4f1a\u4e00\u70b9\u70b9\u6df1\u5165\u4ecb\u7ecd\uff0c\u6b22\u8fce\u5927\u5bb6\u5173\u6ce8GOLANG\u516c\u4f17\u53f7\uff0c\u4e00\u8d77\u5b66\u4e60\u7f16\u7a0b~<\/p>\n<dl>\n<dt>\n <\/dt>\n<dd>\n   win11 hosts\u6587\u4ef6\u4fee\u6539\u540e\u65e0\u6cd5\u4fdd\u5b58\u600e\u4e48\u529e\n <\/dd>\n<\/dl>\n<dl>\n<dt>\n <\/dt>\n<dd>\n   Win10\u7f51\u7edc\u51ed\u636e\u8d26\u6237\u548c\u5bc6\u7801\u5728\u54ea\u91cc \u600e\u4e48\u67e5\u770b\n <\/dd>\n<\/dl>\n","protected":false},"excerpt":{"rendered":"<p>\u54c8\u55bd\uff01\u5927\u5bb6\u597d\uff0c\u5f88\u9ad8\u5174\u53c8\u89c1\u9762\u4e86\uff0c\u6211&#46;&#46;&#46;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4925],"tags":[],"class_list":["post-206548","post","type-post","status-publish","format-standard","hentry","category-4925"],"_links":{"self":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/206548","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/comments?post=206548"}],"version-history":[{"count":0,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/206548\/revisions"}],"wp:attachment":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/media?parent=206548"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/categories?post=206548"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/tags?post=206548"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}