Question

0 0

设计 RESTful 风格的 api, 获取短信验证码的接口应该放在哪个资源下比较好

rt, 除了获取短信验证码的接口, 还会有一些操作, 比如搜索接口, 都只是一个动作, 这些大家在设计 RESTful 风格的 api 时, 是如何设计的呢?

为了更详细的描述这个问题, 我举几个例子, 我指的是放在哪个资源下, 而不是动作
例如
post /users 代表注册
get /users 代表获取用户信息
post /sessions 代表登录
delete /sessions 代表退出
这里 sessions , users 就是资源

restful api设计

9 years, 12 months ago

帅气福小猫

share

帅气福小猫 9 years, 12 months ago

Answer 1

0

这里可以追加问题么？
如果楼主知道麻烦回答下。。
比如说get users，这个借口，如果我想根据用户的状态加其他查询比如用where这跟get users算一个接口，还是两个？

answered 9 years, 12 months ago

从来不起名

share

从来不起名 answered 9 years, 12 months ago

Answer 2

0

这，楼主提问太抽象啦

answered 9 years, 12 months ago

走边路诺八嘎

share

走边路诺八嘎 answered 9 years, 12 months ago

Answer 3

0

我司这么理解的，如果执行资源操作的人是请求者，那就用名词做uri，如果执行资源操作的是服务器或者其他就创建一个服务请求，我记得有一个比较好的例子是转账业务，用transaction做uri。所以短信验证码我觉得用一个创建一个短信通知比较合理。比如sms-notify

answered 9 years, 12 months ago

坂町近次郎

share

坂町近次郎 answered 9 years, 12 months ago

Answer 4

0

哈。我们项目是直接用/api/sms的。当时也没注意这么多，用得是POST，主要是考虑到每次POST 会增加服务器上的某些资源

answered 9 years, 12 months ago

小小小小小纸团

share

小小小小小纸团 answered 9 years, 12 months ago

Answer 5

0

用messageCode来定义资源,然后资源表述定义为get||search,按照你的提问我是这么理解的.

answered 9 years, 12 months ago

沙包二等兵

share

沙包二等兵 answered 9 years, 12 months ago

Answer 6

0

按照 restful 的规范(名字只能是一个名词/资源,不能出现动词),可以如下:


 GET /messageCode 获取验证码
POST /messageCode 刷新验证码
DELETE /messageCode 让那个验证码过期
PUT /messageCode 这个好像用不上...因为直接get那步就搞定了

answered 9 years, 12 months ago

傲娇D小曼

share

傲娇D小曼 answered 9 years, 12 months ago

设计 RESTful 风格的 api, 获取短信验证码的接口应该放在哪个资源下比较好

帅气福小猫

Answers

从来不起名

走边路诺八嘎

坂町近次郎

小小小小小纸团

沙包二等兵

傲娇D小曼

Your Answer