代码之家 › 专栏 › 技术社区 › Erick Gallani

RESTful使用id相同的端点或其他参数是一种好的做法?

restful-url api-design restful-architecture rest

Erick Gallani · 技术社区 · 7 年前

脚本

我有一个案例,当我想通过身份证、普通案例,有时还想通过日期获得一些东西。

例如:

/companies/:id/tickets/:id
/companies/:id/tickets/:date

从我的研究来看,这不是一个好的做法,但我对此表示怀疑。

我应该使用没有 id号 然后使用有效载荷获取日期?

例如:

/companies/:id/tickets

这应该会退还那家公司的所有票,对吗?因此,从有效载荷中获取一些日期数据并将其用作过滤器,在我看来,返回结果并不正确。如果我这样做,我的端点不会诚实地告诉我他们在做什么。

我应该在这里使用什么休息练习?

1 回复 | 直到 7 年前

Dom 7 年前

/companies/:id/tickets/:id -这对于获取单个资源很好。

我想大多数人都会同意,过滤和搜索资源最好使用查询参数。事实上,JSONAPI规范有一个关于它的建议。

阅读 http://jsonapi.org/recommendations/#filtering 以及其他建议,它们涵盖了最常见的用例,例如您的用例。

您还可以有一个独立的 tickets 资源,并为其实现公司id过滤器,通常,为同一个资源提供多个URL是很好的。

推荐文章

Moshe Shaham · 我应该使用现有的websocket连接进行请求/响应操作吗?

3 年前

RustyShackleford · 如何将内容类型为application/x-www-form-urlencoded格式的数据帧行迭代到API POST请求中?

7 年前

Erick Gallani · RESTful使用id相同的端点或其他参数是一种好的做法?

7 年前

ImgPrcSng · 静态库中的符号可见性和操纵

7 年前

Laurent Parmentier · 环回关系从不返回值

7 年前

Sujit · 搜索API的Spring Boot REST设计

7 年前

Lingxi · C中的默认参数vs重载++

7 年前

Dominic Cabral · 如何在JMeter中测试异步回调?

7 年前

user44 · 在ASP中实现“JSON合并补丁”。NET Core-区分null和未定义属性的最佳方法

7 年前

Andy Fenton · API-网站通信。我应该复制逻辑吗?

7 年前