何时/何地在 FastAPI 中使用正文/路径/查询/字段?

Posted

技术标签:

【中文标题】何时/何地在 FastAPI 中使用正文/路径/查询/字段?【英文标题】:When/Where to use Body/Path/Query/Field in FastAPI? 【发布时间】:2021-03-04 00:45:40 【问题描述】:

我正在关注 FastAPI 的 the tutorial,到目前为止,我对 何时/何地在 FastAPI 中使用 Body/Path/Query/Field 有疑问? 因为它们似乎都适用同样,本教程对它们的区别使用了模糊的解释,还是我遗漏了什么?

额外问题* 真的有用吗?我在教程的the sample code 中设置/省略了它,但我看不出有什么区别。

【问题讨论】:

这能回答你的问题吗? When do I use path params vs. query params in a RESTful API? 不,但感谢您的帖子,它在某些方面有所帮助。 【参考方案1】:

其实它们是完全不同的。

我们以带有 FastAPI 链接标签的问题的 URL 为例,进行拆分。

https://***.com/questions/tagged/fastapi?sort=Newest&uqlId=26120
***.com -> 域 /questions -> 路径 /tagged -> 路径 /fastapi -> 路径参数。 sort=Newest -> 查询参数。 uqlId=26120 -> 查询参数。

如果你想在 FastAPI 中创建它,它看起来像这样。

from enum import Enum


class SortTypes(str, Enum):
    newest: str = "Newest"
    unanswered: str = "Unanswered"
    active: str = "Active"
    bountied: str = "Bountied"


@app.get("/questions/tagged/tag")
async def get_questions_with_tags(tag: str, sort: SortTypes, uqlId: int):
    return ...

查询参数和路径参数的工作方式几乎相同。

但身体完全不同。

您看不到来自 URL 的请求正文,您的客户端以字节形式发送 HTTP 正文,但它可以包含任何内容,您需要通过 HTTP 标头指定正文包含的内容。

通过这样做,您是在告诉服务器它应该如何处理该主体。例如

假设您正在发送一个 JSON "name": "foo",它将与此标头 "Content-Type": "application/json" 一起发送,您的客户端会处理此问题,因为默认情况下 FastAPI 返回 JSONResponse,还有其他响应类型,如 StreamingResponse、@987654330 @、htmlResponse 等(您可以从 here 中读取常见的 Content-Type)。

查询参数和路径参数之间的主要区别在于它们可以从 URL 访问并且它们是字符串。但 Body 但通常是携带数据的。

假设您有一个更大的应用程序,并且您使用Query 参数进行客户端和服务器之间的所有通信。这将是一场彻底的灾难。

例如,现在您正在阅读此答案,对吗?但它是怎么来的?您的身份,您的声誉,问题本身的所有详细信息都以正文形式出现。想象一下在 URL 中发送所有这些,完全是灾难。

如需进一步阅读,您可以查看这些答案以查看设计 REST API 的最佳实践。

REST API Best practices: Where to put parameters? REST API Best practices: args in query string vs in request body

【讨论】:

感谢@yagizcan-degirmenci,我更了解查询和路径参数,因此更了解QUERY、PATH、BODY、FIELD。我认为您可以通过以下电话补充您对 Body 的宝贵解释:curl -X PUT "http://127.0.0.1:8000/items4/345?q=holmes" -H "accept: application/json" -H "Content-Type: application/json" -d "\"item\":\"name\":\"string\",\"description\":\"string\",\"price\":0,\"tax\":0,\"user\":\"username\":\"string\",\"full_name\":\"string\",\"importance\":1" @ΟυιλιαμΑρκευα oh ofc,但主体可以是任何类型、图像、base64 编码字符串、JSON 或字节对象等。我将用对主体的更好解释来更新我的答案.谢谢。

以上是关于何时/何地在 FastAPI 中使用正文/路径/查询/字段?的主要内容,如果未能解决你的问题,请参考以下文章

何时何地使用 JMS?

Twig 渲染与包含 - 何时何地使用其中一个?

何时何地使用 LINQ to Objects?

在长过滤器链中何时何地使用 prepareForImageCapture

BaseHTTPServer 和 SimpleHTTPServer 有啥区别?何时何地使用它们?

BaseHTTPServer和SimpleHTTPServer有什么区别?何时何地使用它们?