{"id":129,"date":"2026-06-15T14:13:12","date_gmt":"2026-06-15T06:13:12","guid":{"rendered":"https:\/\/www.52runoob.com\/?p=129"},"modified":"2026-06-15T14:13:12","modified_gmt":"2026-06-15T06:13:12","slug":"fastapi-%e8%b7%af%e5%be%84%e5%8f%82%e6%95%b0","status":"publish","type":"post","link":"https:\/\/www.52runoob.com\/index.php\/2026\/06\/15\/fastapi-%e8%b7%af%e5%be%84%e5%8f%82%e6%95%b0\/","title":{"rendered":"FastAPI \u8def\u5f84\u53c2\u6570"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\u5728 FastAPI \u4e2d\uff0c<strong>\u8def\u5f84\u53c2\u6570\uff08Path Parameters\uff09<\/strong> \u662f URL \u8def\u5f84\u7684\u4e00\u90e8\u5206\uff0c\u7528\u4e8e\u6355\u83b7\u52a8\u6001\u7684\u503c\u3002FastAPI \u4f1a\u5229\u7528 Python \u7684\u7c7b\u578b\u63d0\u793a\uff08Type Hints\uff09\u81ea\u52a8\u5bf9\u8fd9\u4e9b\u53c2\u6570\u8fdb\u884c\u89e3\u6790\u3001\u7c7b\u578b\u8f6c\u6362\u548c\u6570\u636e\u9a8c\u8bc1\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u4ee5\u4e0b\u662f FastAPI \u8def\u5f84\u53c2\u6570\u7684\u6838\u5fc3\u7528\u6cd5\u548c\u8fdb\u9636\u6280\u5de7\uff1a<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u57fa\u672c\u7528\u6cd5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f7f\u7528\u82b1\u62ec\u53f7 <code>{}<\/code> \u5728\u8def\u5f84\u4e2d\u58f0\u660e\u53c2\u6570\uff0c\u5e76\u5728\u51fd\u6570\u4e2d\u5b9a\u4e49\u540c\u540d\u53c2\u6570\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI\n\napp = FastAPI()\n\n# \u8def\u5f84\u4e2d\u58f0\u660e {item_id}\n@app.get(&quot;\/items\/{item_id}&quot;)\nasync def read_item(item_id: str):\n    return {&quot;item_id&quot;: item_id}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u8bbf\u95ee <code>http:\/\/127.0.0.1:8000\/items\/foo<\/code>\uff0c\u5c06\u8fd4\u56de <code>{\"item_id\": \"foo\"}<\/code>\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">2. \u7c7b\u578b\u8f6c\u6362\u4e0e\u81ea\u52a8\u9a8c\u8bc1<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u4f1a\u6839\u636e\u4f60\u63d0\u4f9b\u7684\u7c7b\u578b\u63d0\u793a\u81ea\u52a8\u8f6c\u6362\u6570\u636e\u7c7b\u578b\u3002\u5982\u679c\u8f6c\u6362\u5931\u8d25\uff08\u4f8b\u5982\u4f20\u5165\u4e86\u5b57\u6bcd\u800c\u4e0d\u662f\u6570\u5b57\uff09\uff0c\u5b83\u4f1a\u81ea\u52a8\u8fd4\u56de\u6e05\u6670\u7684 HTTP 422 Unprocessable Entity \u9519\u8bef\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">@app.get(&quot;\/items\/{item_id}&quot;)\nasync def read_item(item_id: int):\n    return {&quot;item_id&quot;: item_id, &quot;type&quot;: type(item_id).__name__}<\/code><\/pre><\/div><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u8bbf\u95ee <code>\/items\/3<\/code>\uff1a\u8fd4\u56de <code>{\"item_id\": 3, \"type\": \"int\"}<\/code><\/li>\n\n\n\n<li>\u8bbf\u95ee <code>\/items\/foo<\/code>\uff1a\u8fd4\u56de 422 \u9519\u8bef\uff0c\u63d0\u793a <code>value is not a valid integer<\/code>\u3002<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">3. \u9884\u5b9a\u4e49\u503c\uff08\u4f7f\u7528 Enum\uff09<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u5e0c\u671b\u8def\u5f84\u53c2\u6570\u53ea\u80fd\u662f\u51e0\u4e2a\u7279\u5b9a\u7684\u503c\uff0c\u53ef\u4ee5\u4f7f\u7528 Python \u7684 <code>Enum<\/code> \u7c7b\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><span>12<\/span><span>13<\/span><span>14<\/span><span>15<\/span><span>16<\/span><span>17<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from enum import Enum\nfrom fastapi import FastAPI\n\napp = FastAPI()\n\nclass ModelName(str, Enum):\n    alexnet = &quot;alexnet&quot;\n    resnet = &quot;resnet&quot;\n    lenet = &quot;lenet&quot;\n\n@app.get(&quot;\/models\/{model_name}&quot;)\nasync def get_model(model_name: ModelName):\n    if model_name == ModelName.alexnet:\n        return {&quot;model_name&quot;: model_name, &quot;message&quot;: &quot;Deep Learning FTW!&quot;}\n\n    # \u53ef\u4ee5\u901a\u8fc7 .value \u83b7\u53d6\u5b57\u7b26\u4e32\u503c\n    return {&quot;model_name&quot;: model_name.value, &quot;message&quot;: &quot;Have some residuals&quot;}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u8bbf\u95ee <code>\/models\/resnet<\/code> \u4f1a\u6b63\u5e38\u54cd\u5e94\uff0c\u4f46\u8bbf\u95ee <code>\/models\/vgg<\/code> \u4f1a\u8fd4\u56de 422 \u9519\u8bef\uff0c\u56e0\u4e3a <code>vgg<\/code> \u4e0d\u5728\u5141\u8bb8\u7684\u679a\u4e3e\u503c\u4e2d\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">4. \u5305\u542b\u8def\u5f84\u7684\u8def\u5f84\u53c2\u6570 (Path containing paths)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u7684\u8def\u5f84\u53c2\u6570\u672c\u8eab\u5305\u542b\u659c\u6760 <code>\/<\/code>\uff08\u4f8b\u5982\u6587\u4ef6\u8def\u5f84\uff09\uff0c\u4f60\u9700\u8981\u4f7f\u7528\u7279\u6b8a\u7684\u8bed\u6cd5 <code>{param_name:path}<\/code>\uff0c\u5e76\u5728\u51fd\u6570\u53c2\u6570\u4e2d\u4f7f\u7528 <code>Path<\/code>\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI, Path\n\napp = FastAPI()\n\n# \u6ce8\u610f {file_path:path} \u7684\u5199\u6cd5\n@app.get(&quot;\/files\/{file_path:path}&quot;)\nasync def read_file(file_path: str = Path(..., description=&quot;The file path to read&quot;)):\n    return {&quot;file_path&quot;: file_path}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u8bbf\u95ee <code>\/files\/home\/johndoe\/myfile.txt<\/code>\uff0c<code>file_path<\/code> \u7684\u503c\u5c06\u662f <code>home\/johndoe\/myfile.txt<\/code>\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">5. \u4f7f\u7528 <code>Path<\/code> \u6dfb\u52a0\u989d\u5916\u9a8c\u8bc1<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f60\u53ef\u4ee5\u4ece <code>fastapi<\/code> \u5bfc\u5165 <code>Path<\/code>\uff0c\u4e3a\u8def\u5f84\u53c2\u6570\u6dfb\u52a0\u66f4\u590d\u6742\u7684\u9a8c\u8bc1\u89c4\u5219\uff08\u5982\u6700\u5c0f\u503c\u3001\u6700\u5927\u503c\u3001\u6b63\u5219\u8868\u8fbe\u5f0f\u7b49\uff09\u3002<code>...<\/code> (Ellipsis) \u8868\u793a\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><span>12<\/span><span>13<\/span><span>14<\/span><span>15<\/span><span>16<\/span><span>17<\/span><span>18<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI, Path\nfrom typing import Annotated # Python 3.9+ \u63a8\u8350\u4f7f\u7528 Annotated\n\napp = FastAPI()\n\n# \u4f20\u7edf\u5199\u6cd5\n@app.get(&quot;\/items\/{item_id}&quot;)\nasync def read_item(\n    item_id: int = Path(..., title=&quot;The ID of the item to get&quot;, ge=1, le=1000)\n):\n    return {&quot;item_id&quot;: item_id}\n\n# \u73b0\u4ee3\u5199\u6cd5 (\u63a8\u8350\uff0cPython 3.9+)\n@app.get(&quot;\/items\/{item_id}&quot;)\nasync def read_item_modern(\n    item_id: Annotated[int, Path(title=&quot;The ID of the item to get&quot;, ge=1, le=1000)]\n):\n    return {&quot;item_id&quot;: item_id}<\/code><\/pre><\/div><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>ge=1<\/code>\uff1a\u5927\u4e8e\u6216\u7b49\u4e8e 1 (greater than or equal)<\/li>\n\n\n\n<li><code>le=1000<\/code>\uff1a\u5c0f\u4e8e\u6216\u7b49\u4e8e 1000 (less than or equal)<\/li>\n\n\n\n<li>\u5982\u679c\u4f20\u5165 <code>0<\/code> \u6216 <code>1001<\/code>\uff0c\u5c06\u8fd4\u56de 422 \u9a8c\u8bc1\u9519\u8bef\u3002<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">6. \u8def\u5f84\u53c2\u6570\u4e0e\u67e5\u8be2\u53c2\u6570\u6df7\u5408\u4f7f\u7528<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u53ef\u4ee5\u65e0\u7f1d\u533a\u5206\u8def\u5f84\u53c2\u6570\u548c\u67e5\u8be2\u53c2\u6570\u3002\u8def\u5f84\u53c2\u6570\u5728 <code>{}<\/code> \u4e2d\u58f0\u660e\uff0c\u67e5\u8be2\u53c2\u6570\u4f5c\u4e3a\u666e\u901a\u7684\u51fd\u6570\u53c2\u6570\u58f0\u660e\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">@app.get(&quot;\/users\/{user_id}\/items&quot;)\nasync def read_user_items(\n    user_id: int, \n    skip: int = 0, \n    limit: int = 10\n):\n    return {\n        &quot;user_id&quot;: user_id, \n        &quot;skip&quot;: skip, \n        &quot;limit&quot;: limit\n    }<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u8bbf\u95ee <code>\/users\/5\/items?skip=20&amp;limit=5<\/code>\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>user_id<\/code> (\u8def\u5f84\u53c2\u6570) = 5<\/li>\n\n\n\n<li><code>skip<\/code> (\u67e5\u8be2\u53c2\u6570) = 20<\/li>\n\n\n\n<li><code>limit<\/code> (\u67e5\u8be2\u53c2\u6570) = 5<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udca1 \u6700\u4f73\u5b9e\u8df5\u603b\u7ed3<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>\u59cb\u7ec8\u4f7f\u7528\u7c7b\u578b\u63d0\u793a<\/strong>\uff1a\u8fd9\u80fd\u8ba9 FastAPI \u63d0\u4f9b\u81ea\u52a8\u7684\u6570\u636e\u9a8c\u8bc1\u548c\u51fa\u8272\u7684 OpenAPI (Swagger) \u6587\u6863\u3002<\/li>\n\n\n\n<li><strong>\u4f18\u5148\u4f7f\u7528 <code>Annotated<\/code><\/strong>\uff1a\u5728\u73b0\u4ee3 Python (3.9+) \u4e2d\uff0c\u4f7f\u7528 <code>Annotated[type, Path(...)]<\/code> \u662f\u5b98\u65b9\u63a8\u8350\u7684\u505a\u6cd5\uff0c\u4ee3\u7801\u66f4\u6e05\u6670\u3002<\/li>\n\n\n\n<li><strong>\u5584\u7528\u679a\u4e3e (Enum)<\/strong>\uff1a\u5bf9\u4e8e\u72b6\u6001\u3001\u5206\u7c7b\u7b49\u56fa\u5b9a\u9009\u9879\uff0c\u4f7f\u7528 Enum \u53ef\u4ee5\u907f\u514d\u975e\u6cd5\u8f93\u5165\uff0c\u5e76\u81ea\u52a8\u751f\u6210 Swagger UI \u4e2d\u7684\u4e0b\u62c9\u9009\u62e9\u6846\u3002<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u6709\u5173\u4e8e\u7279\u5b9a\u573a\u666f\uff08\u5982\u6b63\u5219\u6821\u9a8c\u8def\u5f84\u53c2\u6570\u3001\u52a8\u6001\u8def\u7531\u7b49\uff09\u7684\u95ee\u9898\uff0c\u53ef\u4ee5\u968f\u65f6\u544a\u8bc9\u6211\uff01<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5728 FastAPI \u4e2d\uff0c\u8def\u5f84\u53c2\u6570\uff08Path Paramete&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[14],"tags":[],"class_list":["post-129","post","type-post","status-publish","format-standard","hentry","category-fastapi-"],"_links":{"self":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/129","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/comments?post=129"}],"version-history":[{"count":1,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/129\/revisions"}],"predecessor-version":[{"id":131,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/129\/revisions\/131"}],"wp:attachment":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/media?parent=129"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/categories?post=129"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/tags?post=129"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}