{"id":204831,"date":"2025-05-29T14:39:28","date_gmt":"2025-05-29T06:39:28","guid":{"rendered":"https:\/\/server.hk\/cnblog\/204831\/"},"modified":"2025-05-29T14:39:28","modified_gmt":"2025-05-29T06:39:28","slug":"fastapi-swagger%e6%96%87%e6%a1%a3%ef%bc%9a%e5%a6%82%e4%bd%95%e5%ae%9e%e7%8e%b0%e8%b7%af%e7%94%b1%e5%b5%8c%e5%a5%97%e5%b1%95%e7%a4%ba%ef%bc%9f","status":"publish","type":"post","link":"https:\/\/server.hk\/cnblog\/204831\/","title":{"rendered":"FastAPI Swagger\u6587\u6863\uff1a\u5982\u4f55\u5b9e\u73b0\u8def\u7531\u5d4c\u5957\u5c55\u793a\uff1f"},"content":{"rendered":"<p><b><\/b>     <\/p>\n<h1>FastAPI Swagger\u6587\u6863\uff1a\u5982\u4f55\u5b9e\u73b0\u8def\u7531\u5d4c\u5957\u5c55\u793a\uff1f<\/h1>\n<p>\u6765\u5230\u7684\u5927\u5bb6\uff0c\u76f8\u4fe1\u90fd\u662f\u7f16\u7a0b\u5b66\u4e60\u7231\u597d\u8005\uff0c\u5e0c\u671b\u5728\u8fd9\u91cc\u5b66\u4e60\u6587\u7ae0\u76f8\u5173\u7f16\u7a0b\u77e5\u8bc6\u3002\u4e0b\u9762\u672c\u7bc7\u6587\u7ae0\u5c31\u6765\u5e26\u5927\u5bb6\u804a\u804a\u300aFastAPI Swagger\u6587\u6863\uff1a\u5982\u4f55\u5b9e\u73b0\u8def\u7531\u5d4c\u5957\u5c55\u793a\uff1f\u300b\uff0c\u4ecb\u7ecd\u4e00\u4e0b\uff0c\u5e0c\u671b\u5bf9\u5927\u5bb6\u7684\u77e5\u8bc6\u79ef\u7d2f\u6709\u6240\u5e2e\u52a9\uff0c\u52a9\u529b\u5b9e\u6218\u5f00\u53d1\uff01<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.17golang.com\/uploads\/20241117\/173182106867397e0c8fff3.jpg\" class=\"aligncenter\"><\/p>\n<p><strong>fastapi\u5d4c\u5957\u5c55\u793aswagger\u6587\u6863\u95ee\u9898<\/strong><\/p>\n<p><strong>\u95ee\u9898\uff1a<\/strong><\/p>\n<p>\u5e0c\u671b\u5c06swagger\u6587\u6863\u4e2d\u7684\u8def\u7531\u8fdb\u884c\u5d4c\u5957\u5c55\u793a\uff0c\u4ee5\u5b9e\u73b0\u7c7b\u4f3c\u5982\u4e0b\u6548\u679c\uff1a<\/p>\n<ul>\n<li>\n<p>\u540e\u53f0\u7ba1\u7406<\/p>\n<ul>\n<li>\n<p>\u7528\u6237\u7ba1\u7406<\/p>\n<ul>\n<li>a\u63a5\u53e3<\/li>\n<li>b\u63a5\u53e3<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6587\u7ae0\u7ba1\u7406<\/p>\n<ul>\n<li>c\u63a5\u53e3<\/li>\n<li>d\u63a5\u53e3<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><strong>\u5f53\u524d\u6548\u679c\uff1a<\/strong><\/p>\n<ul>\n<li>\n<p>\u540e\u53f0\u7ba1\u7406<\/p>\n<ul>\n<li>a\u63a5\u53e3<\/li>\n<li>b\u63a5\u53e3<\/li>\n<li>c\u63a5\u53e3<\/li>\n<li>d\u63a5\u53e3<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u7528\u6237\u7ba1\u7406<\/p>\n<ul>\n<li>a\u63a5\u53e3<\/li>\n<li>b\u63a5\u53e3<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6587\u7ae0\u7ba1\u7406<\/p>\n<ul>\n<li>c\u63a5\u53e3<\/li>\n<li>d\u63a5\u53e3<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><strong>\u4ee3\u7801\uff1a<\/strong><\/p>\n<pre>routerAdmin = APIRouter(\n    prefix='\/admin',\n    tags=['\u540e\u53f0\u7ba1\u7406']\n)\n\n# routerUser\u6587\u4ef6a,b\u8def\u7531\nrouterAdmin.include_router(routerUser)\n# routerAdmin\u6587\u4ef6c,d\u8def\u7531\nrouterAdmin.include_router(routerArticle)\n\napp = FastAPI()\n\napp.include_router(routerAdmin)<\/pre>\n<p><strong>\u56de\u7b54\uff1a<\/strong><\/p>\n<p>\u76ee\u524d openapi \u89c4\u8303\u8fd8\u4e0d\u652f\u6301\u5d4c\u5957\u529f\u80fd\u3002\u867d\u7136\u66fe\u6709\u63d0\u51fa\u5bf9\u6b64\u529f\u80fd\u7684\u9700\u6c42\uff0c\u4f46\u5c1a\u672a\u5f97\u5230\u5b9e\u73b0\u3002<\/p>\n<p>\u4e0d\u8fc7\uff0c\u636e\u4e86\u89e3\uff0c\u6709\u4e2a\u63d2\u4ef6\u53ef\u4ee5\u5b9e\u73b0\u7c7b\u4f3c\u6807\u98981|\u6807\u98982|\u6807\u98983\u7684\u6548\u679c\uff0c\u4f46\u8fd8\u672a\u5f97\u5230\u8bc1\u5b9e\u3002<\/p>\n<p>\u7ec8\u4e8e\u4ecb\u7ecd\u5b8c\u5566\uff01\u5c0f\u4f19\u4f34\u4eec\uff0c\u8fd9\u7bc7\u5173\u4e8e\u300aFastAPI Swagger\u6587\u6863\uff1a\u5982\u4f55\u5b9e\u73b0\u8def\u7531\u5d4c\u5957\u5c55\u793a\uff1f\u300b\u7684\u4ecb\u7ecd\u5e94\u8be5\u8ba9\u4f60\u6536\u83b7\u591a\u591a\u4e86\u5427\uff01\u6b22\u8fce\u5927\u5bb6\u6536\u85cf\u6216\u5206\u4eab\u7ed9\u66f4\u591a\u9700\u8981\u5b66\u4e60\u7684\u670b\u53cb\u5427~\u516c\u4f17\u53f7\u4e5f\u4f1a\u53d1\u5e03\u6587\u7ae0\u76f8\u5173\u77e5\u8bc6\uff0c\u5feb\u6765\u5173\u6ce8\u5427\uff01<\/p>\n","protected":false},"excerpt":{"rendered":"<p>FastAPI Swagger\u6587&#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-204831","post","type-post","status-publish","format-standard","hentry","category-4925"],"_links":{"self":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/204831","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=204831"}],"version-history":[{"count":0,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/204831\/revisions"}],"wp:attachment":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/media?parent=204831"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/categories?post=204831"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/tags?post=204831"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}