这是一个创建于 2454 天前的主题，其中的信息可能已经有所发展或是发生改变。
评论文章接口
叫 /api/comment/create 参数 articleId,content
还是 /api/article/comment 参数 id,content
哪个好？ 或者两个都不好，有什么其他更好的写法吗？
还有获取文章的评论列表
/api/comment/getList 参数 articleId
/api/article/comments 参数 id
似乎没有什么书专门说 api 命名的事，有什么质量高点的博客之类的资料可以看看吗
------------------更新一下-------------------
刚刚在淘宝看到两本书《 Web API 的设计与开发》《 RESTful Web APIs 》，有看过这两本书的吗 感觉咋样？
还有其他什么书可以推荐一下吗？
叫 /api/comment/create 参数 articleId,content
还是 /api/article/comment 参数 id,content
哪个好？ 或者两个都不好，有什么其他更好的写法吗？
还有获取文章的评论列表
/api/comment/getList 参数 articleId
/api/article/comments 参数 id
似乎没有什么书专门说 api 命名的事，有什么质量高点的博客之类的资料可以看看吗
------------------更新一下-------------------
刚刚在淘宝看到两本书《 Web API 的设计与开发》《 RESTful Web APIs 》，有看过这两本书的吗 感觉咋样？
还有其他什么书可以推荐一下吗？
 | 1 DavidNineRoc 2019-01-31 13:02:31 +08:00  2 多看一下 RESTFul 的文章, 文章的评论结构,既然是该文章下的,那么就应该从 url 中看的出来 如: /api/v1/articles/{article}/comments => post: 新建 get: 获取列表 /api/v1/articles/{article}/comments/{comment} => delete: 删除评论 |
 | 2 GDC 2019-01-31 13:11:09 +08:00 via iPhone 1 个人觉得 RESTful 挺恶心的，把很多问题搞复杂了。而且 RESTful 只是一种推荐风格，也不是什么标准。 |
 | 3 luotian 2019-01-31 13:14:40 +08:00 1 |
 | 4 stillsilly OP @DavidNineRoc 谢谢 我不想用 method 表示操作类型咋么办 不知道为什么，我们公司所有人所有项目，全部统一用的 post，我也被他们传染了，感觉这样还挺方便 前后端沟通接口从来不说请求类型，也不会因为不小心弄错类型拿不到数据…… 这样做有什么不好的地方吗…… |
 | 5 jonahtan 2019-01-31 13:27:46 +08:00 2 /api/v1.0/articles/comments/{id}/{do} /api/版本号 /业务域 /服务 /编号索引 /操作项 |
 | 6 namesc 2019-01-31 13:29:29 +08:00 1 我觉得 RESTful API 挺繁琐的，不喜欢，它是一种公开约定，其实就是建议。 不一定要用这个，使用这个规范的不多，阿里云腾讯云那些有海量 API 的产品也没用这个规范。 |
| 7 stillsilly OP |
 | 8 lynskylate 2019-01-31 13:34:00 +08:00 via Android 1 对于文章这种资源 restful 是非常合适的 |
 | 9 wc951 2019-01-31 19:26:42 +08:00 1 你可以看下 github 的 api 是怎么设计的，那个是很标准的 restful 风格，而且是使用了成熟度最高的 HATEOAS 模型 |
Select Language