RESTAPI最佳实践:POST请求中的数据应该在哪里传递?参数、端点、主体?

RESTAPI最佳实践:POST请求中的数据应该在哪里传递?参数、端点、主体?,rest,django-rest-framework,restful-url,flask-restful,Rest,Django Rest Framework,Restful Url,Flask Restful,我知道这是一个相当普遍的问题,但我已经四处搜索,找不到任何关于API设计的最佳实践或指导原则,特别是在POST/PUT请求中接受数据 那么,在设计API时要遵循哪些最佳实践?您是否遵循任何规则或指导原则 谢谢 通常,当数据发布到HTTP服务器时,与发布内容相关的相关数据将在正文中 我说一般是因为有例外 对于PUT,情况更是如此,数据确实应该在正文中。如果PUT请求中没有正文,则请求的含义是:“请将此资源替换为0字节资源”。好的,谢谢!这就是我一直在做的事情,但后来我看到一篇文章说,API应该尽可

我知道这是一个相当普遍的问题,但我已经四处搜索,找不到任何关于API设计的最佳实践或指导原则,特别是在
POST
/
PUT
请求中接受数据

那么,在设计API时要遵循哪些最佳实践?您是否遵循任何规则或指导原则


谢谢

通常,当数据发布到HTTP服务器时,与发布内容相关的相关数据将在正文中

我说一般是因为有例外


对于
PUT
,情况更是如此,数据确实应该在正文中。如果
PUT
请求中没有正文,则请求的含义是:“请将此资源替换为0字节资源”。

好的,谢谢!这就是我一直在做的事情,但后来我看到一篇文章说,API应该尽可能直观,如果数据相当简单,那么最好将其作为参数传递,而不是传递到正文中。@Zach我想大多数人都会不同意这篇文章:)直观对我来说也是“最不令人惊讶的”,大多数人将在正文中传递数据,在标题中传递元数据。