api 结构取舍?

2015-10-29 20:42:17 +08:00
 plantain
#### 获得当前用户加入的组织、当前用户创建的组织

a. `/user/joined/organizations`和`/user/created/organizations`

b. `/user/organizations?relation=joined/created`

#### 加入组织、踢出组织

c. `post` `/organizations/:organization_id/users/:user_id/joined`和`delete` `/organizations/:organization_id/users/:user_id/joined`

d. `post` `/organizations/:organization_id/memberships`和`delete` `/organizations/:organization_id/memberships/:user_id`

a 和 b 哪个好些? c 和 d 哪个好些?
1326 次点击
所在节点    问与答
2 条回复
Kilerd
2015-10-29 21:11:22 +08:00
a c 更偏向于 restful 吧。其实如果系统是自己设计,自己用(就是团队内部),两个都没差

主要的是写好文档, = =! 格式统一一下就好,不要一个是这个风格,一个又是那种风格的。


BTW , 我个人的话更喜欢用 b 这一种。
msg7086
2015-10-29 21:31:24 +08:00
GET /my/orgs/joined
GET /my/orgs/created

CREATE /orgs/:id/members/:username
DELETE /orgs/:id/members/:username

我大概会设计成这样。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/232109

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX