{"id":2863,"date":"2019-02-19T13:41:47","date_gmt":"2019-02-19T05:41:47","guid":{"rendered":"https:\/\/damogame.cn:15443\/wordpress\/?p=2863"},"modified":"2019-02-19T13:42:24","modified_gmt":"2019-02-19T05:42:24","slug":"%e4%bd%bf%e7%94%a8go-swagger%e4%b8%bagolang-api%e8%87%aa%e5%8a%a8%e7%94%9f%e6%88%90swagger%e6%96%87%e6%a1%a3","status":"publish","type":"post","link":"https:\/\/i007.cc\/wordpress\/archives\/2863","title":{"rendered":"\u4f7f\u7528go-swagger\u4e3agolang API\u81ea\u52a8\u751f\u6210swagger\u6587\u6863"},"content":{"rendered":"<article class=\"article\" data-v-2c4167e9=\"\">\n<h1 class=\"article-title\" data-v-2c4167e9=\"\">\u4ec0\u4e48\u662fswagger\uff1f<\/h1>\n<div class=\"article-content\" data-id=\"5b05142af265da0b9b07b042\" data-v-2c4167e9=\"\">\n<p><a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fswagger.io\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Swagger<\/a>\u662f\u4e00\u4e2a\u7b80\u5355\u4f46\u529f\u80fd\u5f3a\u5927\u7684API\u8868\u8fbe\u5de5\u5177\u3002\u5b83\u5177\u6709\u5730\u7403\u4e0a\u6700\u5927\u7684API\u5de5\u5177\u751f\u6001\u7cfb\u7edf\uff0c\u6570\u4ee5\u5343\u8ba1\u7684\u5f00\u53d1\u4eba\u5458\uff0c\u4f7f\u7528\u51e0\u4e4e\u6240\u6709\u7684\u73b0\u4ee3\u7f16\u7a0b\u8bed\u8a00\uff0c\u90fd\u5728\u652f\u6301\u548c\u4f7f\u7528Swagger\u3002\u4f7f\u7528Swagger\u751f\u6210API\uff0c\u6211\u4eec\u53ef\u4ee5\u5f97\u5230\u4ea4\u4e92\u5f0f\u6587\u6863\uff0c\u81ea\u52a8\u751f\u6210\u4ee3\u7801\u7684SDK\u4ee5\u53caAPI\u7684\u53d1\u73b0\u7279\u6027\u7b49\u3002<\/p>\n<h3 class=\"heading\" data-id=\"heading-1\">swagger\u6587\u6863\u957f\u5565\u6837\uff1f<\/h3>\n<p>\u4e00\u4e2a\u6700\u7b80\u5355\u7684swagger\u6587\u6863\u793a\u4f8b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">swagger: \"2.0\"\r\n\r\ninfo:\r\n  version: 1.0.0\r\n  title: Simple API\r\n  description: A simple API to learn how to write OpenAPI Specification\r\n\r\nschemes:\r\n  - https\r\nhost: simple.api\r\nbasePath: \/openapi101\r\n\r\npaths: {}<\/pre>\n<p>Tips:\u9605\u8bfb\u672c\u6587\u524d\u63d0\u662f\u5047\u8bbe\u4f60\u5df2\u7ecf\u4e86\u89e3\u4e86\u5982\u4f55\u7f16\u5199swagger\u6587\u6863\uff0c\u5f53\u7136\uff0c\u5982\u679c\u8fd8\u4e0d\u4e86\u89e3\u4e5f\u6ca1\u5173\u7cfb\uff0c\u53ef\u4ee5\u53bb<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fswagger.io%2Fdocs%2Fspecification%2F2-0%2Fadding-examples%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">swagger\u5b98\u7f51<\/a>\u67e5\u770b\u6587\u6863\u8fdb\u884c\u5b66\u4e60\uff0c\u5e76\u4e14\u8fd9\u91cc\u8fd8\u6709\u4e00\u5957<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Flegacy.gitbook.com%2Fbook%2Fhuangwenchao%2Fswagger%2Fdetails\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\u300aSwagger\u4ece\u5165\u95e8\u5230\u7cbe\u901a\u300b<\/a>\u9644\u4e0a.<\/p>\n<h3 class=\"heading\" data-id=\"heading-2\">\u672c\u6587\u80cc\u666f\u4ecb\u7ecd<\/h3>\n<p>\u200b \u5199\u4f5c\u672c\u6587\u7684\u539f\u56e0\u662f\u56e0\u4e3a\u516c\u53f8\u8981\u6c42api\u6587\u6863\u90fd\u4f7f\u7528 swagger\u683c\u5f0f\uff0c\u9879\u76ee\u662f\u7528golang\u7f16\u5199\u7684\uff0c\u4f5c\u4e3a\u4e00\u4e2a\u61d2\u764c\u7a0b\u5e8f\u5458\uff0c\u600e\u4e48\u80fd\u591f\u5fcd\u53d7\u53bb\u7f16\u5199\u8fd9\u4e48\u590d\u6742\u7684swagger\u6587\u6863\u5462\uff1f\u6709\u6ca1\u6709\u4e00\u952e\u751f\u6210\u7684\u5de5\u5177\u5462\uff1fgoogle\u4e00\u4e0b\uff0c\u8fd8\u771f\u6709,\u90a3\u5c31\u662f<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgithub.com%2Fgo-swagger%2Fgo-swagger\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">go-swagger<\/a>\u9879\u76ee\u3002go-swagger\u4f17\u591a\u7279\u8272\u529f\u80fd\u4e4b\u4e00\u5c31\u662f<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgithub.com%2Fgo-swagger%2Fgo-swagger%23generate-a-spec-from-source\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Generate a spec from source<\/a>,\u5373\u901a\u8fc7\u6e90\u7801\u751f\u6210\u6587\u6863\uff0c\u5f88\u7b26\u5408\u6211\u7684\u9700\u6c42\u3002<\/p>\n<p>\u4e0b\u9762\u5c31\u7b80\u5355\u4ecb\u7ecd\u4e0b\u5982\u4f55\u4e3a\u9879\u76ee\u52a0\u4e0aswagger\u6ce8\u91ca\uff0c\u7136\u540e\u4e00\u952e\u751f\u6210API\u6587\u6863<\/p>\n<p>\u5f00\u59cb\u4e4b\u524d\u9700\u8981\u5b89\u88c5\u4e24\u4e2a\u5de5\u5177\uff1a<\/p>\n<ul>\n<li>swagger-editor:\u7528\u4e8e\u7f16\u5199swagger\u6587\u6863\uff0cUI\u5c55\u793a\uff0c\u751f\u6210\u4ee3\u7801\u7b49&#8230;<\/li>\n<li>go-swagger:\u7528\u4e8e\u4e00\u952e\u751f\u6210API\u6587\u6863<\/li>\n<\/ul>\n<p>\u5b89\u88c5swagger-editor,\u6211\u8fd9\u91cc\u4f7f\u7528docker\u8fd0\u884c\uff0c\u5176\u4ed6\u5b89\u88c5\u65b9\u5f0f\uff0c\u8bf7\u67e5\u770b<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fswagger.io%2Fdocs%2Fswagger-tools%2F%23swagger-editor\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\u5b98\u65b9\u6587\u6863<\/a>\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">docker pull swaggerapi\/swagger-editor\r\ndocker run --rm -p 80:8080 swaggerapi\/swagger-editor<\/pre>\n<pre><code class=\"hljs shell copyable\" lang=\"shell\"><\/code><\/pre>\n<p>\u5b89\u88c5go-swagger,\u6211\u8fd9\u8fb9\u4f7f\u7528brew\u5b89\u88c5\uff0c\u5176\u4ed6\u5b89\u88c5\u65b9\u5f0f\uff0c\u8bf7\u67e5\u770b<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgoswagger.io%2F%23installing\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\u5b98\u65b9\u6587\u6863<\/a><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">brew tap go-swagger\/go-swagger\r\nbrew install go-swagger<\/pre>\n<pre><code class=\"hljs shell copyable\" lang=\"shell\"><\/code><\/pre>\n<p>\u597d\u4e86\uff0c\u73b0\u5728\u7ec8\u4e8e\u5f00\u59cb\u6b63\u9898\uff1astart coding!!!<\/p>\n<h3 class=\"heading\" data-id=\"heading-3\">\u5f00\u59cb\u7f16\u5199\u6ce8\u91ca<\/h3>\n<p>1.\u5047\u8bbe\u6709\u4e00\u4e2auser.server\uff0c\u63d0\u4f9b\u4e00\u4e9bREST API\uff0c\u7528\u4e8e\u5bf9\u7528\u6237\u6570\u636e\u7684\u589e\u5220\u6539\u67e5\u3002<\/p>\n<p>\u6bd4\u5982\u8fd9\u91cc\u6709\u4e00\u4e2a<code>getOneUser<\/code>\u63a5\u53e3\uff0c\u662f\u67e5\u8be2\u7528\u6237\u4fe1\u606f\u7684\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">package service\r\n\r\nimport (\r\n    \"encoding\/json\"\r\n    \"fmt\"\r\n    \"net\/http\"\r\n    \"strconv\"\r\n    \"user.server\/models\"\r\n    \"github.com\/Sirupsen\/logrus\"\r\n)\r\n\r\ntype GetUserParam struct {\r\n    Id int `json:\"id\"`\r\n}\r\n\r\nfunc GetOneUser(w http.ResponseWriter, r *http.Request) {\r\n    defer r.Body.Close()\r\n    decoder := json.NewDecoder(r.Body)\r\n    var param GetUserParam\r\n    err := decoder.Decode(&amp;param)\r\n    if err != nil {\r\n        WriteResponse(w, ErrorResponseCode, \"request param is invalid, please check!\", nil)\r\n        return\r\n    }\r\n\r\n    \/\/ get user from db\r\n    user, err := models.GetOne(strconv.Itoa(param.Id))\r\n    if err != nil {\r\n        logrus.Warn(err)\r\n        WriteResponse(w, ErrorResponseCode, \"failed\", nil)\r\n        return\r\n    }\r\n    WriteResponse(w, SuccessResponseCode, \"success\", user)\r\n}<\/pre>\n<pre><code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<p>\u6839\u636eswagger\u6587\u6863\u89c4\u8303\uff0c\u4e00\u4e2aswagger\u6587\u6863\u9996\u5148\u8981\u6709swagger\u7684\u7248\u672c\u548cinfo\u4fe1\u606f\u3002\u5229\u7528go-swagger\u53ea\u9700\u8981\u5728\u58f0\u660epackage\u4e4b\u524d\u52a0\u4e0a\u5982\u4e0b\u6ce8\u91ca\u5373\u53ef\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">\/\/ Package classification User API.\r\n\/\/\r\n\/\/ The purpose of this service is to provide an application\r\n\/\/ that is using plain go code to define an API\r\n\/\/\r\n\/\/      Host: localhost\r\n\/\/      Version: 0.0.1\r\n\/\/\r\n\/\/ swagger:meta\r\npackage service<\/pre>\n<pre><code class=\"hljs shell copyable\" lang=\"shell\"><\/code><\/pre>\n<p>\u7136\u540e\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u4f7f\u7528<code>swagger generate spec -o .\/swagger.json<\/code>\u547d\u4ee4\u751f\u6210<code>swagger.json<\/code>\u6587\u4ef6\uff1a<\/p>\n<p>\u6b64\u547d\u4ee4\u4f1a\u627e\u5230main.go\u5165\u53e3\u6587\u4ef6\uff0c\u7136\u540e\u904d\u5386\u6240\u6709\u6e90\u7801\u6587\u4ef6\uff0c\u89e3\u6790\u7136\u540e\u751f\u6210swagger.json\u6587\u4ef6<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">{\r\n  \"swagger\": \"2.0\",\r\n  \"info\": {\r\n    \"description\": \"The purpose of this service is to provide an application\\nthat is using plain go code to define an API\",\r\n    \"title\": \"User API.\",\r\n    \"version\": \"0.0.1\"\r\n  },\r\n  \"host\": \"localhost\",\r\n  \"paths\": {}\r\n}<\/pre>\n<pre><code class=\"hljs json copyable\" lang=\"json\"><\/code><\/pre>\n<p>2.\u57fa\u672c\u4fe1\u606f\u6709\u4e86\uff0c\u7136\u540e\u5c31\u8981\u6709\u8def\u7531\uff0c\u8bf7\u6c42\uff0c\u54cd\u5e94\u7b49\uff0c\u4e0b\u9762\u9488\u5bf9getOneUser\u63a5\u53e3\u7f16\u5199swagger\u6ce8\u91ca\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">\/\/ swagger:parameters getSingleUser\r\ntype GetUserParam struct {\r\n    \/\/ an id of user info\r\n    \/\/\r\n    \/\/ Required: true\r\n    \/\/ in: path\r\n    Id int `json:\"id\"`\r\n}\r\n\r\nfunc GetOneUser(w http.ResponseWriter, r *http.Request) {\r\n    \/\/ swagger:route GET \/users\/{id} users getSingleUser\r\n    \/\/\r\n    \/\/ get a user by userID\r\n    \/\/\r\n    \/\/ This will show a user info\r\n    \/\/\r\n    \/\/     Responses:\r\n    \/\/       200: UserResponse\r\n    decoder := json.NewDecoder(r.Body)\r\n    var param GetUserParam\r\n    err := decoder.Decode(&amp;param)\r\n    if err != nil {\r\n        WriteResponse(w, ErrorResponseCode, \"request param is invalid, please check!\", nil)\r\n        return\r\n    }\r\n\r\n    \/\/ get user from db\r\n    user, err := models.GetOne(strconv.Itoa(param.Id))\r\n    if err != nil {\r\n        logrus.Warn(err)\r\n        WriteResponse(w, ErrorResponseCode, \"failed\", nil)\r\n        return\r\n    }\r\n    WriteResponse(w, SuccessResponseCode, \"success\", user)\r\n}<\/pre>\n<pre><code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<p>\u53ef\u4ee5\u770b\u5230\u5728<code>GetUserParam<\/code>\u7ed3\u6784\u4f53\u4e0a\u9762\u52a0\u4e86\u4e00\u884c<code>swagger:parameters getSingleUser<\/code>\u7684\u6ce8\u91ca\u4fe1\u606f\uff0c\u8fd9\u662f\u58f0\u660e\u63a5\u53e3\u7684\u5165\u53c2\u6ce8\u91ca\uff0c\u7ed3\u6784\u4f53\u5185\u90e8\u7684\u51e0\u884c\u6ce8\u91ca\u6307\u660e\u4e86id\u8fd9\u4e2a\u53c2\u6570\u5fc5\u586b\uff0c\u5e76\u4e14\u67e5\u8be2\u53c2\u6570id\u662f\u5728url path\u4e2d\u3002\u8be6\u7ec6\u7528\u6cd5\uff0c\u53c2\u8003:<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgoswagger.io%2Fgenerate%2Fspec%2Fparams.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\"> swagger:params<\/a><\/p>\n<p>\u5728<code>GetOneUser<\/code>\u51fd\u6570\u4e2d\uff1a<\/p>\n<ul>\n<li><code>swagger:route<\/code>\u6307\u660e\u4f7f\u7528\u7684http method\uff0c\u8def\u7531\uff0c\u4ee5\u53ca\u6807\u7b7e\u548coperation id,\u8be6\u7ec6\u7528\u6cd5\uff0c\u53c2\u8003\uff1a<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgoswagger.io%2Fgenerate%2Fspec%2Froute.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">swagger:route<\/a><\/li>\n<li><code>Responses<\/code>\u6307\u660e\u4e86\u8fd4\u56de\u503c\u7684code\u4ee5\u53ca\u7c7b\u578b<\/li>\n<\/ul>\n<p>\u7136\u540e\u518d\u58f0\u660e\u54cd\u5e94:<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">\/\/ User Info\r\n\/\/\r\n\/\/ swagger:response UserResponse\r\ntype UserWapper struct {\r\n    \/\/ in: body\r\n    Body ResponseMessage\r\n}\r\n\r\ntype ResponseMessage struct {\r\n    Code    int         `json:\"code\"`\r\n    Message string      `json:\"message\"`\r\n    Data    interface{} `json:\"data\"`\r\n}<\/pre>\n<pre><code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<p>\u4f7f\u7528<code>swagger:response<\/code>\u8bed\u6cd5\u58f0\u660e\u8fd4\u56de\u503c\uff0c\u5176\u4e0a\u4e24\u884c\u662f\u8fd4\u56de\u503c\u7684\u63cf\u8ff0\uff08\u6211\u4e5f\u4e0d\u6e05\u695a\uff0c\u4e3a\u5565\u63cf\u8ff0\u4fe1\u606f\u8981\u5199\u5728\u4e0a\u9762\uff0c\u6b22\u8fce\u89e3\u60d1\uff09,\u8be6\u7ec6\u7528\u6cd5\uff0c\u53c2\u8003\uff1b<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgoswagger.io%2Fgenerate%2Fspec%2Fresponse.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\"> swagger:response<\/a><\/p>\n<p>\u7136\u540e\u6d4f\u89c8\u5668\u8bbf\u95ee<code>localhost<\/code>,\u67e5\u770bswagger-editor\u754c\u9762,\u70b9\u51fb\u5de5\u5177\u680f\u4e2d\u7684<code>File-&gt;Impoprt File<\/code>\u4e0a\u4f20\u521a\u624d\u751f\u6210\u7684 <code>swagger.json<\/code>\u6587\u4ef6\uff0c\u5c31\u53ef\u4ee5\u770b\u5230\u754c\u9762\uff1a<\/p>\n<figure><img class=\"lazyload\" data-src=\"https:\/\/user-gold-cdn.xitu.io\/2018\/5\/23\/1638bd48f7612107?imageView2\/0\/w\/1280\/h\/960\/ignore-error\/1\" data-width=\"1280\" data-height=\"588\" \/><figcaption><\/figcaption><\/figure>\n<p>\u8fd9\u6837\u4e00\u4e2a\u7b80\u5355\u7684api\u6587\u6863\u5c31\u751f\u6210\u4e86<\/p>\n<p>3.\u600e\u4e48\u6837\uff1f\u662f\u4e0d\u662f\u5f88\u7b80\u5355\uff1f\u53ef\u662f\u53c8\u611f\u89c9\u90a3\u91cc\u4e0d\u5bf9\uff0c\u55ef\uff0c\u6ce8\u91ca\u90fd\u5199\u5728\u4ee3\u7801\u91cc\u4e86\uff0c\u5f88\u4e0d\u7f8e\u89c2\uff0c\u800c\u4e14\u4e0d\u6613\u7ef4\u62a4\u3002\u60f3\u4e00\u4e0bgo-swagger\u7684\u539f\u7406\u662f\u626b\u63cf\u76ee\u5f55\u4e0b\u7684\u6240\u6709go\u6587\u4ef6\uff0c\u89e3\u6790\u6ce8\u91ca\u4fe1\u606f\u3002\u90a3\u4e48\u662f\u4e0d\u662f\u53ef\u4ee5\u628aapi\u6ce8\u91ca\u90fd\u96c6\u4e2d\u5199\u5728\u5355\u4e2a\u6587\u4ef6\u5185\uff0c\u7edf\u4e00\u7ba1\u7406\uff0c\u514d\u5f97\u5206\u6563\u5728\u5404\u4e2a\u6e90\u7801\u6587\u4ef6\u5185\u3002<\/p>\n<p>\u65b0\u5efa\u4e00\u4e2a<code>doc.go<\/code>\u6587\u4ef6\uff0c\u8fd9\u91cc\u8fd8\u6709\u4e00\u4e2a\u63a5\u53e3\u662f<code>UpdateUser<\/code>,\u90a3\u4e48\u6211\u4eec\u5728doc.go\u6587\u4ef6\u4e2d\u58f0\u660e\u6b64\u63a5\u53e3\u7684api\u6ce8\u91ca\u3002\u5148\u770b\u4e00\u4e0b<code>UpdateUser<\/code>\u63a5\u53e3\u7684\u4ee3\u7801\uff1a<\/p>\n<pre><code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">func UpdateUser(w http.ResponseWriter, r *http.Request) {\r\n    defer r.Body.Close()\r\n    \/\/ decode body data into user struct\r\n    decoder := json.NewDecoder(r.Body)\r\n    user := models.User{}\r\n    err := decoder.Decode(&amp;user)\r\n    if err != nil {\r\n        WriteResponse(w, ErrorResponseCode, \"user data is invalid, please check!\", nil)\r\n        return\r\n    }\r\n\r\n    \/\/ check if user exists\r\n    data, err := models.GetUserById(user.Id)\r\n    if err != nil {\r\n        logrus.Warn(err)\r\n        WriteResponse(w, ErrorResponseCode, \"query user failed\", nil)\r\n        return\r\n    }\r\n    if data.Id == 0 {\r\n        WriteResponse(w, ErrorResponseCode, \"user not exists, no need to update\", nil)\r\n        return\r\n    }\r\n\r\n    \/\/ update\r\n    _, err = models.Update(user)\r\n    if err != nil {\r\n        WriteResponse(w, ErrorResponseCode, \"update user data failed, please try again!\", nil)\r\n        return\r\n    }\r\n    WriteResponse(w, SuccessResponseCode, \"update user data success!\", nil)\r\n}<code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<pre><code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<p>\u7136\u540e\u518ddoc.go\u6587\u4ef6\u4e2d\u7f16\u5199\u5982\u4e0b\u58f0\u660e\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"null\">package service\r\n\r\nimport \"user.server\/models\"\r\n\r\n\/\/ swagger:parameters UpdateUserResponseWrapper\r\ntype UpdateUserRequest struct {\r\n    \/\/ in: body\r\n    Body models.User\r\n}\r\n\r\n\/\/ Update User Info\r\n\/\/\r\n\/\/ swagger:response UpdateUserResponseWrapper\r\ntype UpdateUserResponseWrapper struct {\r\n    \/\/ in: body\r\n    Body ResponseMessage\r\n}\r\n\r\n\/\/ swagger:route POST \/users users UpdateUserResponseWrapper\r\n\/\/\r\n\/\/ Update User\r\n\/\/\r\n\/\/ This will update user info\r\n\/\/\r\n\/\/     Responses:\r\n\/\/       200: UpdateUserResponseWrapper<\/pre>\n<pre><code class=\"hljs golang copyable\" lang=\"golang\"><\/code><\/pre>\n<p>\u8fd9\u6837\u5c31\u628aapi\u58f0\u660e\u6ce8\u91ca\u7ed9\u62bd\u79bb\u51fa\u6765\u4e86\uff0c\u7136\u540e\u4f7f\u7528\u547d\u4ee4<code>swagger generate spec -o .\/swagger.json<\/code>\u751f\u6210json\u6587\u4ef6,\u5c31\u53ef\u4ee5\u770b\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff1a<\/p>\n<figure><img class=\"lazyload\" data-src=\"https:\/\/user-gold-cdn.xitu.io\/2018\/5\/23\/1638bd48f6fc290e?imageView2\/0\/w\/1280\/h\/960\/ignore-error\/1\" data-width=\"1280\" data-height=\"591\" \/><figcaption><\/figcaption><\/figure>\n<p>\u5f88\u7b80\u5355\u5427\uff0c\u53c2\u7167\u6587\u6863\u7f16\u5199\u51e0\u884c\u6ce8\u91ca\uff0c\u7136\u540e\u4e00\u4e2a\u547d\u4ee4\u751f\u6210API\u6587\u6863\u3002\u61d2\u764c\u7a0b\u5e8f\u5458\u798f\u97f3~<\/p>\n<p>\u672c\u6587\u6240\u6709\u793a\u4f8b\u4ee3\u7801\u6258\u7ba1\u5728<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fbitbucket.org%2Frick-chang%2Fuser.service%2Fsrc%2Fmaster%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\u8fd9\u91cc<\/a>, \u539f\u6587<a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fpopwalker.github.io%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\u5730\u5740<\/a><\/p>\n<p>\u53c2\u8003\uff1a<\/p>\n<ul>\n<li><a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fswagger.io%2Fdocs%2Fswagger-tools%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">swagger\u5b98\u65b9Doc<\/a><\/li>\n<li><a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Flegacy.gitbook.com%2Fbook%2Fhuangwenchao%2Fswagger%2Fdetails\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Swagger\u4ece\u5165\u95e8\u5230\u7cbe\u901a<\/a><\/li>\n<li><a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgoswagger.io%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">go-swagger\u6587\u6863<\/a><\/li>\n<li><a href=\"https:\/\/link.juejin.im\/?target=https%3A%2F%2Fgithub.com%2Fgo-swagger%2Fgo-swagger%2F\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">go-swagger\u7684github\u4e3b\u9875<\/a><\/li>\n<\/ul>\n<\/div>\n<\/article>\n<div class=\"tag-list-box\" data-v-173f5205=\"\" data-v-2c4167e9=\"\">\n<div class=\"tag-list-title\" data-v-173f5205=\"\" data-v-2c4167e9=\"\">\u5173\u6ce8\u4e0b\u9762\u7684\u6807\u7b7e\uff0c\u53d1\u73b0\u66f4\u591a\u76f8\u4f3c\u6587\u7ae0<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>\u4ec0\u4e48\u662fswagger\uff1f Swagger\u662f<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"colormag_page_container_layout":"default_layout","colormag_page_sidebar_layout":"default_layout","footnotes":""},"categories":[],"tags":[122],"class_list":["post-2863","post","type-post","status-publish","format-standard","hentry","tag-06-godocker"],"_links":{"self":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/posts\/2863","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/comments?post=2863"}],"version-history":[{"count":0,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/posts\/2863\/revisions"}],"wp:attachment":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/media?parent=2863"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/categories?post=2863"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/tags?post=2863"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}