{"id":1620,"date":"2025-03-13T10:55:18","date_gmt":"2025-03-13T02:55:18","guid":{"rendered":"https:\/\/www.tqazy.com\/?p=1620"},"modified":"2025-03-13T10:59:40","modified_gmt":"2025-03-13T02:59:40","slug":"swagger%e7%9a%84%e4%bd%bf%e7%94%a8","status":"publish","type":"post","link":"https:\/\/www.tqazy.com\/?p=1620","title":{"rendered":"Swagger\u7684\u4f7f\u7528"},"content":{"rendered":"

\u6211\u4eec\u65e5\u5e38\u90fd\u662f\u57fa\u4e8e\u63a5\u53e3\u5f00\u53d1\u9879\u76ee\uff0c\u4e00\u822c\u5148\u8bd5\u7528postman\u6216\u8005\u5176\u4ed6\u63a5\u53e3\u7ba1\u7406\u5de5\u5177\u548c\u524d\u7aef\u5bf9\u597d\u63a5\u53e3\u3002\u7136\u540e\u53cc\u65b9\u6309\u7167\u63a5\u53e3\u5f00\u53d1\u5185\u5bb9\u518d\u8fdb\u884c\u8c03\u8bd5\u3002<\/p>\n

\u4f46\u662f\u6709\u65f6\u5019\uff0c\u9700\u8981\u540e\u7aef\u81ea\u5df1\u751f\u6210\u63a5\u53e3\u6587\u6863\uff0c\u90a3\u4e48\u6211\u4eec\u5c31\u53ef\u4ee5\u91c7\u7528Swagger\u6280\u672f\uff0c\u5728\u4ee3\u7801\u4e2d\u690d\u5165\u4f9d\u8d56\u548c\u6ce8\u89e3\u3002\u7136\u540e\u4e00\u952e\u751f\u6210\u63a5\u53e3\u6587\u6863\uff0c\u540c\u65f6\u53ef\u4ee5\u7528\u4e8e\u8c03\u8bd5\u548c\u4fdd\u5b58\u3002<\/p>\n

Swagger\u5bf9\u4e8eRestfulAPI\u98ce\u683c\u7684\u63a5\u53e3\u53ef\u4ee5\u5f88\u597d\u7684\u9002\u7528\u3002<\/p>\n

\u90a3\u4e48\u4e0b\u9762\u6211\u5c31\u4ecb\u7ecd\u4e00\u4e0b\u5982\u4f55\u5728\u9879\u76ee\u4e2d\u4f7f\u7528Swagger\uff08\u4ee5SpringBoot\u9879\u76ee\u4e3a\u4f8b\uff09\uff1a<\/p>\n

<\/div>\n

\u4e00\u3001\u5f15\u5165\u4f9d\u8d56<\/h1>\n
    <dependencies>\n        <!-- RestfulWeb\u7684\u4f9d\u8d56 -->\n        <dependency>\n            <groupId>org.springframework.boot<\/groupId>\n            <artifactId>spring-boot-starter-web<\/artifactId>\n        <\/dependency>\n        <!-- Lombok\u7684\u4f9d\u8d56 -->\n        <dependency>\n            <groupId>org.projectlombok<\/groupId>\n            <artifactId>lombok<\/artifactId>\n            <optional>true<\/optional>\n        <\/dependency>\n        <!-- Swagger\u7684\u4f9d\u8d56 -->\n        <dependency>\n            <groupId>com.github.xiaoymin<\/groupId>\n            <artifactId>knife4j-openapi2-spring-boot-starter<\/artifactId>\n            <version>4.1.0<\/version>\n        <\/dependency>\n    <\/dependencies><\/code><\/pre>\n
<\/div>\n
\u4e8c\u3001\u914d\u7f6e\u6587\u4ef6<\/h1>\n
\u5728 [application.yml] \u4e2d\u8fdb\u884c\u914d\u7f6e<\/p>\n
server:\n  port: 8080\n\nknife4j:\n  enable: true # \u5f00\u542f\n  openapi:\n    title: \u7528\u6237\u7ba1\u7406\u63a5\u53e3\u6587\u6863\n    description: "\u7528\u6237\u7ba1\u7406\u63a5\u53e3\u6587\u6863"\n    email: 2451203736@qq.com\n    concat: \u9676\u5176\n    url: https:\/\/www.tqazy.com\n    version: v1.0.0\n    group:\n      default:\n        group-name: default\n        api-rule: package\n        api-rule-resources:\n          - com.tqazy.test_swagger.controller # \u626b\u63cfController\u6240\u5728\u5305\u5730\u5740<\/code><\/pre>\n
<\/div>\n
\u4e09\u3001\u793a\u4f8b\u4ee3\u7801<\/h1>\n
UserController.java<\/p>\n
import com.tqazy.test_swagger.domain.dto.UserFormDTO;\nimport io.swagger.annotations.*;\nimport org.springframework.web.bind.annotation.*;\n\n@Api("\u7528\u6237\u7ba1\u7406\u63a5\u53e3")\n@RestController\n@RequestMapping("\/users")\npublic class UserController {\n\n    @ApiOperation(value = "\u65b0\u589e\u7528\u6237\u63a5\u53e3", notes = "\u8be5\u65b9\u6cd5\u7528\u4e8e\u5728\u7cfb\u7edf\u4e2d\u65b0\u589e\u4e00\u4e2a\u7528\u6237\u7684\u4fe1\u606f")\n    @PostMapping("\/addUser")\n    @ApiResponses({\n            @ApiResponse(code = 200, message = "\u65b0\u589e\u7528\u6237\u6210\u529f"),\n            @ApiResponse(code = 500, message = "\u670d\u52a1\u5668\u5185\u90e8\u9519\u8bef")\n    })\n    public String addUser(@ApiParam("\u7528\u6237\u8868\u5355\u6a21\u578b\u4fe1\u606f") @RequestBody UserFormDTO userDTO) {\n        return "\u6f14\u793a\u4ee3\u7801\uff0c\u65b0\u589e\u7528\u6237\u6210\u529f\uff01";\n    }\n}<\/code><\/pre>\n
<\/div>\n
UserFormDTO.java<\/p>\n
import io.swagger.annotations.ApiModel;\nimport io.swagger.annotations.ApiModelProperty;\nimport lombok.Data;\n\n@Data\n@ApiModel(value = "\u7528\u6237\u8868\u5355\u6a21\u578b", description = "\u8be5\u6a21\u578b\u7528\u4e8e\u65b0\u589e\/\u4fee\u6539\u7528\u6237\u65f6\u586b\u5199\u7684\u7528\u6237\u8868\u5355\u4fe1\u606f")\npublic class UserFormDTO {\n\n    @ApiModelProperty(value = "\u7528\u6237\u540d", example = "\u86ee\u5409", required = true)\n    private String username;\n\n    @ApiModelProperty(value = "8")\n    private String age;\n\n    @ApiModelProperty(value = "\u7528\u6237\u5730\u5740", example = "\u795e\u5723\u517d\u56fd\u6e38\u5c3e\u90e1\u7a9d\u7a9d\u4e61")\n    private String address;\n}<\/code><\/pre>\n
<\/div>\n
\u56db\u3001\u8fd0\u884c\u6d4b\u8bd5<\/h1>\n
\u542f\u52a8SpringBoot\u9879\u76ee\uff0c\u6d4f\u89c8\u5668\u8bbf\u95eelocalhost:8080\/doc.html<\/code><\/p>\n
\"\"<\/div><\/p>\n
\"\"<\/div><\/p>\n
<\/div>\n
\u4e94\u3001\u6ce8\u89e3\u4f7f\u7528\u89e3\u6790<\/h1>\n
5.1 \u63a7\u5236\u5668\u7c7b\u6ce8\u89e3<\/h2>\n
5.1.1 @Api<\/code><\/h3>\n
    \n
  • \u7528\u6cd5\uff1a<\/strong> \u7528\u4e8e\u5bf9\u63a7\u5236\u5668\u7c7b\u8fdb\u884c\u8bf4\u660e\uff0c\u63cf\u8ff0\u8be5\u7c7b\u7684\u4e3b\u8981\u529f\u80fd\u3002<\/li>\n
  • \u53c2\u6570\uff1a<\/strong> value<\/code> \u8868\u793a\u63a7\u5236\u5668\u7684\u552f\u4e00\u6807\u8bc6\uff1btags<\/code> \u8868\u793a\u8be5\u63a7\u5236\u5668\u7684\u6807\u7b7e\uff0c\u7528\u4e8e\u5206\u7ec4\u5c55\u793a\u3002<\/li>\n
  • \u793a\u4f8b\uff1a<\/strong>\n
    @Api("\u7528\u6237\u7ba1\u7406\u63a5\u53e3")<\/code><\/pre>\n<\/li>\n
  • \u6548\u679c\uff1a<\/strong>
    \n
    \"\"<\/div><\/li>\n<\/ul>\n
    <\/div>\n
    5.2 \u63a7\u5236\u5668\u65b9\u6cd5\u6ce8\u89e3<\/h2>\n
    5.2.1 @ApiOperation<\/code><\/h3>\n
      \n
    • \u7528\u6cd5\uff1a<\/strong> \u7528\u4e8e\u5bf9\u63a7\u5236\u5668\u4e2d\u7684\u65b9\u6cd5\u8fdb\u884c\u8bf4\u660e\uff0c\u63cf\u8ff0\u8be5\u65b9\u6cd5\u7684\u529f\u80fd\u3002<\/li>\n
    • \u53c2\u6570\uff1a<\/strong> value<\/code> \u8868\u793a\u65b9\u6cd5\u7684\u7b80\u77ed\u63cf\u8ff0\uff1bnotes<\/code> \u8868\u793a\u65b9\u6cd5\u7684\u8be6\u7ec6\u63cf\u8ff0\u3002<\/li>\n
    • \u793a\u4f8b\u4ee3\u7801\uff1a<\/strong>\n
      @ApiOperation(value = "\u65b0\u589e\u7528\u6237\u63a5\u53e3", notes = "\u8be5\u65b9\u6cd5\u7528\u4e8e\u5728\u7cfb\u7edf\u4e2d\u65b0\u589e\u4e00\u4e2a\u7528\u6237\u7684\u4fe1\u606f")<\/code><\/pre>\n<\/li>\n
    • \u6548\u679c\uff1a<\/strong>
      \n
      \"\"<\/div><\/li>\n<\/ul>\n
      <\/div>\n
      5.2.2 @ApiResponses<\/code> \u548c @ApiResponse<\/code><\/h3>\n
        \n
      • \u7528\u6cd5\uff1a<\/strong> @ApiResponses<\/code> \u7528\u4e8e\u6279\u91cf\u5b9a\u4e49\u65b9\u6cd5\u7684\u54cd\u5e94\u4fe1\u606f\uff0c@ApiResponse<\/code> \u7528\u4e8e\u5b9a\u4e49\u5355\u4e2a\u54cd\u5e94\u4fe1\u606f\uff0c\u63cf\u8ff0\u65b9\u6cd5\u53ef\u80fd\u8fd4\u56de\u7684\u72b6\u6001\u7801\u53ca\u5bf9\u5e94\u7684\u542b\u4e49\u3002<\/li>\n
      • \u53c2\u6570\uff1a<\/strong> code<\/code> \u8868\u793a\u72b6\u6001\u7801\uff1bmessage<\/code> \u8868\u793a\u72b6\u6001\u7801\u5bf9\u5e94\u7684\u63cf\u8ff0\u4fe1\u606f\u3002<\/li>\n
      • \u793a\u4f8b\u4ee3\u7801\uff1a<\/strong>\n
        @ApiResponses({\n        @ApiResponse(code = 200, message = "\u65b0\u589e\u7528\u6237\u6210\u529f"),\n        @ApiResponse(code = 500, message = "\u670d\u52a1\u5668\u5185\u90e8\u9519\u8bef")\n})<\/code><\/pre>\n<\/li>\n
      • \u6548\u679c\uff1a<\/strong>
        \n
        \"\"<\/div><\/li>\n<\/ul>\n
        <\/div>\n
        5.3 \u65b9\u6cd5\u53c2\u6570\u6ce8\u89e3<\/h2>\n
        5.3.1 @ApiParam<\/code><\/h3>\n
          \n
        • \u7528\u6cd5\uff1a<\/strong> \u7528\u4e8e\u5bf9\u65b9\u6cd5\u7684\u53c2\u6570\u8fdb\u884c\u8bf4\u660e\uff0c\u63cf\u8ff0\u53c2\u6570\u7684\u542b\u4e49\u3001\u662f\u5426\u5fc5\u4f20\u7b49\u4fe1\u606f\u3002<\/li>\n
        • \u53c2\u6570\uff1a<\/strong> value<\/code> \u8868\u793a\u53c2\u6570\u7684\u7b80\u77ed\u63cf\u8ff0\uff1brequired<\/code> \u8868\u793a\u8be5\u53c2\u6570\u662f\u5426\u5fc5\u4f20\uff1bexample<\/code> \u8868\u793a\u53c2\u6570\u7684\u793a\u4f8b\u503c\u3002<\/li>\n
        • \u793a\u4f8b\u4ee3\u7801\uff1a<\/strong>\n
          @ApiParam("\u7528\u6237\u8868\u5355\u6a21\u578b\u4fe1\u606f")<\/code><\/pre>\n
          \u6548\u679c\uff1a<\/strong>
          \n
          \"\"<\/div><\/p>\n<\/li>\n<\/ul>\n
          <\/div>\n
          5.4 \u6a21\u578b\u7c7b\u6ce8\u89e3<\/h2>\n
          5.4.1 @ApiModel<\/code><\/h3>\n
            \n
          • \u7528\u6cd5\uff1a<\/strong> \u7528\u4e8e\u5bf9\u6a21\u578b\u7c7b\u8fdb\u884c\u8bf4\u660e\uff0c\u63cf\u8ff0\u8be5\u7c7b\u7684\u4e3b\u8981\u7528\u9014\u3002<\/li>\n
          • \u53c2\u6570\uff1a<\/strong> value<\/code> \u8868\u793a\u6a21\u578b\u7c7b\u7684\u552f\u4e00\u6807\u8bc6\uff1bdescription<\/code> \u8868\u793a\u6a21\u578b\u7c7b\u7684\u8be6\u7ec6\u63cf\u8ff0\u3002<\/li>\n
          • \u793a\u4f8b\u4ee3\u7801\uff1a<\/strong>\n
            @ApiModel(value = "\u7528\u6237\u8868\u5355\u6a21\u578b", description = "\u8be5\u6a21\u578b\u7528\u4e8e\u65b0\u589e\/\u4fee\u6539\u7528\u6237\u65f6\u586b\u5199\u7684\u7528\u6237\u8868\u5355\u4fe1\u606f")<\/code><\/pre>\n
            \u6548\u679c\uff1a<\/strong>
            \n
            \"\"<\/div><\/p>\n<\/li>\n<\/ul>\n
            <\/div>\n
            5.4.2 @ApiModelProperty<\/code><\/h3>\n
              \n
            • \u7528\u6cd5\uff1a<\/strong> \u7528\u4e8e\u5bf9\u6a21\u578b\u7c7b\u7684\u5c5e\u6027\u8fdb\u884c\u8bf4\u660e\uff0c\u63cf\u8ff0\u5c5e\u6027\u7684\u542b\u4e49\u3001\u793a\u4f8b\u503c\u7b49\u4fe1\u606f\u3002<\/li>\n
            • \u53c2\u6570\uff1a<\/strong> value<\/code> \u8868\u793a\u5c5e\u6027\u7684\u7b80\u77ed\u63cf\u8ff0\uff1bexample<\/code> \u8868\u793a\u5c5e\u6027\u7684\u793a\u4f8b\u503c\uff1brequired = true<\/code> \u8868\u793a\u5c5e\u6027\u4e3a\u5fc5\u586b\uff0c\u9ed8\u8ba4\u503c\uff1afalse<\/code>\u3002<\/li>\n
            • \u793a\u4f8b\u4ee3\u7801\uff1a<\/strong>\n
              @ApiModelProperty(value = "\u7528\u6237\u540d", example = "\u86ee\u5409", required = true)\nprivate String username;<\/code><\/pre>\n<\/li>\n
            • \u6548\u679c\uff1a<\/strong>
              \n
              \"\"<\/div>
              \n
              \"\"<\/div><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
              \u9879\u76ee\u4e2d\u5f15\u5165Swagger\uff0cSwagger\u76f8\u5173\u6ce8\u89e3\u7684\u4f7f\u7528\u548c\u751f\u6210\u6548\u679c\u3002<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[102],"tags":[116],"class_list":["post-1620","post","type-post","status-publish","format-standard","hentry","category-spring_boot","tag-api"],"yoast_head":"\nSwagger\u7684\u4f7f\u7528 | \u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.tqazy.com\/?p=1620\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Swagger\u7684\u4f7f\u7528 | \u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2\" \/>\n<meta property=\"og:description\" content=\"\u9879\u76ee\u4e2d\u5f15\u5165Swagger\uff0cSwagger\u76f8\u5173\u6ce8\u89e3\u7684\u4f7f\u7528\u548c\u751f\u6210\u6548\u679c\u3002\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.tqazy.com\/?p=1620\" \/>\n<meta property=\"og:site_name\" content=\"\u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2\" \/>\n<meta property=\"article:published_time\" content=\"2025-03-13T02:55:18+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-13T02:59:40+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg\" \/>\n<meta name=\"author\" content=\"\u9676\u5176\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"\u9676\u5176\" \/>\n\t<meta name=\"twitter:label2\" content=\"\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 \u5206\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.tqazy.com\/?p=1620\"},\"author\":{\"name\":\"\u9676\u5176\",\"@id\":\"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e\"},\"headline\":\"Swagger\u7684\u4f7f\u7528\",\"datePublished\":\"2025-03-13T02:55:18+00:00\",\"dateModified\":\"2025-03-13T02:59:40+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.tqazy.com\/?p=1620\"},\"wordCount\":14,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e\"},\"image\":{\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#primaryimage\"},\"thumbnailUrl\":\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg\",\"keywords\":[\"API\u6587\u6863\"],\"articleSection\":[\"Spring Boot\"],\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.tqazy.com\/?p=1620#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.tqazy.com\/?p=1620\",\"url\":\"https:\/\/www.tqazy.com\/?p=1620\",\"name\":\"Swagger\u7684\u4f7f\u7528 | \u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2\",\"isPartOf\":{\"@id\":\"https:\/\/www.tqazy.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#primaryimage\"},\"thumbnailUrl\":\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg\",\"datePublished\":\"2025-03-13T02:55:18+00:00\",\"dateModified\":\"2025-03-13T02:59:40+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.tqazy.com\/?p=1620\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#primaryimage\",\"url\":\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg\",\"contentUrl\":\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.tqazy.com\/?p=1620#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\/\/www.tqazy.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Swagger\u7684\u4f7f\u7528\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.tqazy.com\/#website\",\"url\":\"https:\/\/www.tqazy.com\/\",\"name\":\"\u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2\",\"description\":\"\u5f53\u4e0b\uff0c\u5373\u662f\u672a\u6765\",\"publisher\":{\"@id\":\"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e\"},\"alternateName\":\"TaoQi's Blog\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.tqazy.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"zh-Hans\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e\",\"name\":\"\u9676\u5176\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.tqazy.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2024\/06\/20240604021741672.jpg\",\"contentUrl\":\"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2024\/06\/20240604021741672.jpg\",\"width\":940,\"height\":940,\"caption\":\"\u9676\u5176\"},\"logo\":{\"@id\":\"https:\/\/www.tqazy.com\/#\/schema\/person\/image\/\"},\"description\":\"\u4e00\u4e2a\u5f88\u61d2\u7684\u7a0b\u5e8f\u5458\",\"sameAs\":[\"https:\/\/www.tqazy.com\"],\"url\":\"https:\/\/www.tqazy.com\/?author=1\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Swagger\u7684\u4f7f\u7528 | \u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.tqazy.com\/?p=1620","og_locale":"zh_CN","og_type":"article","og_title":"Swagger\u7684\u4f7f\u7528 | \u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2","og_description":"\u9879\u76ee\u4e2d\u5f15\u5165Swagger\uff0cSwagger\u76f8\u5173\u6ce8\u89e3\u7684\u4f7f\u7528\u548c\u751f\u6210\u6548\u679c\u3002","og_url":"https:\/\/www.tqazy.com\/?p=1620","og_site_name":"\u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2","article_published_time":"2025-03-13T02:55:18+00:00","article_modified_time":"2025-03-13T02:59:40+00:00","og_image":[{"url":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg","type":"","width":"","height":""}],"author":"\u9676\u5176","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"\u9676\u5176","\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4":"3 \u5206"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.tqazy.com\/?p=1620#article","isPartOf":{"@id":"https:\/\/www.tqazy.com\/?p=1620"},"author":{"name":"\u9676\u5176","@id":"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e"},"headline":"Swagger\u7684\u4f7f\u7528","datePublished":"2025-03-13T02:55:18+00:00","dateModified":"2025-03-13T02:59:40+00:00","mainEntityOfPage":{"@id":"https:\/\/www.tqazy.com\/?p=1620"},"wordCount":14,"commentCount":0,"publisher":{"@id":"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e"},"image":{"@id":"https:\/\/www.tqazy.com\/?p=1620#primaryimage"},"thumbnailUrl":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg","keywords":["API\u6587\u6863"],"articleSection":["Spring Boot"],"inLanguage":"zh-Hans","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.tqazy.com\/?p=1620#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.tqazy.com\/?p=1620","url":"https:\/\/www.tqazy.com\/?p=1620","name":"Swagger\u7684\u4f7f\u7528 | \u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2","isPartOf":{"@id":"https:\/\/www.tqazy.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.tqazy.com\/?p=1620#primaryimage"},"image":{"@id":"https:\/\/www.tqazy.com\/?p=1620#primaryimage"},"thumbnailUrl":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg","datePublished":"2025-03-13T02:55:18+00:00","dateModified":"2025-03-13T02:59:40+00:00","breadcrumb":{"@id":"https:\/\/www.tqazy.com\/?p=1620#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.tqazy.com\/?p=1620"]}]},{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.tqazy.com\/?p=1620#primaryimage","url":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg","contentUrl":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2025\/03\/20250313023609478.jpg"},{"@type":"BreadcrumbList","@id":"https:\/\/www.tqazy.com\/?p=1620#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/www.tqazy.com\/"},{"@type":"ListItem","position":2,"name":"Swagger\u7684\u4f7f\u7528"}]},{"@type":"WebSite","@id":"https:\/\/www.tqazy.com\/#website","url":"https:\/\/www.tqazy.com\/","name":"\u9676\u5176\u7684\u4e2a\u4eba\u535a\u5ba2","description":"\u5f53\u4e0b\uff0c\u5373\u662f\u672a\u6765","publisher":{"@id":"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e"},"alternateName":"TaoQi's Blog","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.tqazy.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"zh-Hans"},{"@type":["Person","Organization"],"@id":"https:\/\/www.tqazy.com\/#\/schema\/person\/b2e89d56e70f15c261012417c5ef2c4e","name":"\u9676\u5176","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.tqazy.com\/#\/schema\/person\/image\/","url":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2024\/06\/20240604021741672.jpg","contentUrl":"https:\/\/oss.tqazy.com\/wordpress\/autoFile\/2024\/06\/20240604021741672.jpg","width":940,"height":940,"caption":"\u9676\u5176"},"logo":{"@id":"https:\/\/www.tqazy.com\/#\/schema\/person\/image\/"},"description":"\u4e00\u4e2a\u5f88\u61d2\u7684\u7a0b\u5e8f\u5458","sameAs":["https:\/\/www.tqazy.com"],"url":"https:\/\/www.tqazy.com\/?author=1"}]}},"_links":{"self":[{"href":"https:\/\/www.tqazy.com\/index.php?rest_route=\/wp\/v2\/posts\/1620","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.tqazy.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tqazy.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tqazy.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tqazy.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1620"}],"version-history":[{"count":4,"href":"https:\/\/www.tqazy.com\/index.php?rest_route=\/wp\/v2\/posts\/1620\/revisions"}],"predecessor-version":[{"id":1635,"href":"https:\/\/www.tqazy.com\/index.php?rest_route=\/wp\/v2\/posts\/1620\/revisions\/1635"}],"wp:attachment":[{"href":"https:\/\/www.tqazy.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1620"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tqazy.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1620"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tqazy.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1620"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}