{"id":205311,"date":"2025-05-29T17:56:45","date_gmt":"2025-05-29T09:56:45","guid":{"rendered":"https:\/\/server.hk\/cnblog\/205311\/"},"modified":"2025-05-29T17:56:45","modified_gmt":"2025-05-29T09:56:45","slug":"fastapi-swagger%e6%96%87%e6%a1%a3%e5%a6%82%e4%bd%95%e5%ae%9e%e7%8e%b0%e5%b5%8c%e5%a5%97%e6%8e%a5%e5%8f%a3%e5%b1%95%e7%a4%ba%ef%bc%9f","status":"publish","type":"post","link":"https:\/\/server.hk\/cnblog\/205311\/","title":{"rendered":"FastAPI Swagger\u6587\u6863\u5982\u4f55\u5b9e\u73b0\u5d4c\u5957\u63a5\u53e3\u5c55\u793a\uff1f"},"content":{"rendered":"<p><b><\/b>     <\/p>\n<h1>FastAPI Swagger\u6587\u6863\u5982\u4f55\u5b9e\u73b0\u5d4c\u5957\u63a5\u53e3\u5c55\u793a\uff1f<\/h1>\n<p>\u672c\u7bc7\u6587\u7ae0\u5411\u5927\u5bb6\u4ecb\u7ecd\u300aFastAPI Swagger\u6587\u6863\u5982\u4f55\u5b9e\u73b0\u5d4c\u5957\u63a5\u53e3\u5c55\u793a\uff1f\u300b\uff0c\u4e3b\u8981\u5305\u62ec\uff0c\u5177\u6709\u4e00\u5b9a\u7684\u53c2\u8003\u4ef7\u503c\uff0c\u9700\u8981\u7684\u670b\u53cb\u53ef\u4ee5\u53c2\u8003\u4e00\u4e0b\u3002<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.17golang.com\/uploads\/20241128\/1732793081674852f9cc7a8.jpg\" class=\"aligncenter\"><\/p>\n<p><strong>fastapi swagger \u6587\u6863\u7684\u5d4c\u5957\u5c55\u793a<\/strong><\/p>\n<p>\u60f3\u8981\u5728 swagger \u6587\u6863\u4e2d\u5c55\u793a\u5d4c\u5957\u7ed3\u6784\uff0c\u4f8b\u5982\u540e\u53f0\u7ba1\u7406\u4e0b\u5305\u542b\u7528\u6237\u7ba1\u7406\u548c\u6587\u7ae0\u7ba1\u7406\uff0c\u7528\u6237\u7ba1\u7406\u4e0b\u5305\u542b a \u63a5\u53e3\u548c b \u63a5\u53e3\uff0c\u6587\u7ae0\u7ba1\u7406\u4e0b\u5305\u542b c \u63a5\u53e3\u548c d \u63a5\u53e3\u3002<\/p>\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>\u671f\u671b\u6548\u679c\uff1a<\/strong><\/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>\u4ee3\u7801\uff1a<\/strong><\/p>\n<pre>routerAdmin = APIRouter(\n    prefix='\/admin',\n    tags=['\u540e\u53f0\u7ba1\u7406']\n)\n\n# routerUser \u5305\u542b a, b \u63a5\u53e3\nrouterAdmin.include_router(routerUser, prefix='\/user')\n\n# routerArticle \u5305\u542b c, d \u63a5\u53e3\nrouterAdmin.include_router(routerArticle, prefix='\/article')\n\napp = FastAPI()\n\napp.include_router(routerAdmin)<\/pre>\n<p><strong>\u5b9e\u73b0\uff1a<\/strong><\/p>\n<p>\u76ee\u524d openapi \u89c4\u8303\u4e0d\u652f\u6301\u5d4c\u5957\u7ed3\u6784\u3002\u56e0\u6b64\uff0c\u65e0\u6cd5\u4f7f\u7528 fastapi \u7684\u5185\u7f6e swagger ui \u6765\u5b9e\u73b0\u4e0a\u8ff0\u5d4c\u5957\u5c55\u793a\u6548\u679c\u3002<\/p>\n<p>\u7136\u800c\uff0c\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u7b2c\u4e09\u65b9\u63d2\u4ef6\u6765\u5b9e\u73b0\u5d4c\u5957\u5c55\u793a\u3002\u4f8b\u5982\uff0cfastapi-swaggerui-template \u63d2\u4ef6\u53ef\u4ee5\u63d0\u4f9b\u81ea\u5b9a\u4e49 swagger ui \u6a21\u7248\uff0c\u5e76\u652f\u6301\u5d4c\u5957\u7ed3\u6784\u7684\u5c55\u793a\u3002<\/p>\n<p>\u4f46\u662f\uff0c\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u7b2c\u4e09\u65b9\u63d2\u4ef6\u7684\u4f7f\u7528\u53ef\u80fd\u4f1a\u5f15\u5165\u989d\u5916\u7684\u4f9d\u8d56\u5173\u7cfb\u548c\u590d\u6742\u6027\uff0c\u9700\u8981\u8c28\u614e\u9009\u62e9\u3002<\/p>\n<p>\u7406\u8bba\u8981\u638c\u63e1\uff0c\u5b9e\u64cd\u4e0d\u80fd\u843d\uff01\u4ee5\u4e0a\u5173\u4e8e\u300aFastAPI Swagger\u6587\u6863\u5982\u4f55\u5b9e\u73b0\u5d4c\u5957\u63a5\u53e3\u5c55\u793a\uff1f\u300b\u7684\u8be6\u7ec6\u4ecb\u7ecd\uff0c\u5927\u5bb6\u90fd\u638c\u63e1\u4e86\u5427\uff01\u5982\u679c\u60f3\u8981\u7ee7\u7eed\u63d0\u5347\u81ea\u5df1\u7684\u80fd\u529b\uff0c\u90a3\u4e48\u5c31\u6765\u5173\u6ce8\u516c\u4f17\u53f7\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-205311","post","type-post","status-publish","format-standard","hentry","category-4925"],"_links":{"self":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/205311","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=205311"}],"version-history":[{"count":0,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/205311\/revisions"}],"wp:attachment":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/media?parent=205311"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/categories?post=205311"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/tags?post=205311"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}