我正在编写一个RESTful Web服务来upsert并获取我的应用程序的配置。只有一个文档/记录,因为这是全局配置。我的问题是如何将其纳入RESTful标准?
对于upsert,是"创建"的控制器方法。或者"更新"最合适的(分别是POST或PUT的动词)?
对于fetch,是" index"的控制器方法。或"显示"更正确吗?如果是前者,是否可以返回单个对象,或者它应该是长度为1的数组?对于后者,让路由排除id参数是否可以接受(因为那里总是一个并且没有必要)?
我是否过度思考这个问题,或过分强调" REST合规性/一致性&#34 ;?或许整件事情都错了,我不应该写这项服务。我应该提一下,这个API比任何东西更内部,只是我们的前端用于与后端通信的内容。因此,虽然没有第三方担心,但我仍然希望维护开发人员不要混淆。
谢谢!
答案 0 :(得分:2)
我不认为这是一个问题。以下是我设计此API的方法:
GET /api/configuration
- 获取配置
PUT /api/configuration
- 更新配置
PATCH /api/configuration
- 部分更新配置