如何在 FastAPI 中使用相同路径参数定义多个 API 端点？

在 FastAPI 中定义具有相同路径参数的多个 API 端点

在 FastAPI 中，定义具有相同路径参数但不同的多个 API 端点路径并不简单。由于端点评估的顺序很重要，无论请求的具体路径如何，首先定义的端点都将始终被触发。

问题

考虑以下路由器文件其中定义了三个端点，每个端点具有不同的路径，但共享“project_id”路径参数：

</p><h1 id="GET-API-Endpoint">GET API Endpoint 1</h1><p>@router.get("/project/{project_id}/{employee_id}")<br>async def method_one(project_id: str,organization_id: str, session: AsyncSession = Depends(get_db)):</p> <pre class="brush:php;toolbar:false"># ...

GET API 端点 2

@router.get("/project/details/{project_id}")
async def method_two(project_id: str, session: AsyncSession = Depends(get_db) )):

# ...

GET API 端点 3

@router.get("/project/metadata/{project_id}")
async def method_two(project_id: str, session) : AsyncSession = Depends(get_db)):

# ...

此代码表现出意外行为，其中 API 端点 2 和 3 调用端点 1 中定义的控制器方法 (method_one ()).

原因

在 FastAPI 中，端点评估是按顺序发生的。因此，首先评估端点 1（“/project/{project_id}/{employee_id}”）。当向端点 2 或端点 3 发出后续请求时，FastAPI 会将路径的“/project/{project_id}”部分解释为端点 1 的 project_id 参数。这会导致调用端点 1 的控制器方法。

解决方案

要解决此问题，应颠倒端点定义的顺序，以便在包含附加路径的端点之前定义具有相同路径参数的端点参数：

</p><h1 id="GET-API-端点">GET API 端点 2</h1><p>@router.get("/project/details/{project_id} ")</p><pre class="brush:php;toolbar:false"># ...

获取 API 端点 3

@router.get("/project/metadata/{project_id}")

# ...

获取 API 端点 1

@router.get("/project/{project_id}/{employee_id}")

# ...

通过进行此修改，FastAPI将首先评估端点 2 和 3，确保在向这些端点发出请求时执行适当的控制器方法。

以上是如何在 FastAPI 中使用相同路径参数定义多个 API 端点？的详细内容。更多信息请关注PHP中文网其他相关文章！