2024年最全我是如何根据豆瓣api来理解Restful API设计的(5)，2024年最新Golang开发进阶吃透这一篇必拿60W年薪

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

name	method	api
获取图书信息	get	/v2/book/:id
用户收藏某本图书	post	/v2/book/:id/collection
用户修改对某本图书的收藏	put	/v2/book/:id/collection
用户删除对某个图书的收藏	delete	/v2/book/:id/collection

• 另外，在一些不符合curd的情况下，使用　post。
• 把动作转换成资源

比如，上述接口中，用户收藏某本书对外暴露的接口是"/v2/book/:id/collection",收藏动作通过post方法来展现，而不直接写着api中，collection “收藏”，名次，动作直接转换成了资源。

###4.选择合适的状态码

http请求需要返回状态码，约定俗成的状态码能够帮助开发团队提高沟通效率。

• 2xx: 请求正常处理并返回
• 3xx: 重定向
• 4xx: 客户端请求有错误
• 5xx: 服务端请求有错误

比如豆瓣api返回的状态码说明：

状态码	含义	说明
200	ok	请求成功
201	created	创建成功
202	accepted	更新成功
400	bad request	请求不存在
401	unauthorized	未授权
403	forbidden	禁止访问
404	not found	资源不存在
500	internal server error	内部错误

5.使用通用的错误码

通用错误码，具体产品由具体产品api给出。比如豆瓣api:

错误码	错误信息	含义
999	unknow_v2_error	未知错误
1000	need_permission	需要权限
1001	uri_not_found	资源不存在
…	…	…

太多了，只列出几条，具体见豆瓣 api。

6. 安全

这部分内容不属于这篇文章，但是稍微说明下：

• 使用https
• 使用jwt验证
• 使用参数签名，防止参数被篡改。
• 使用权限验证，shiro ,或者自己建数据库（用户、角色、权限）

7.api文档

接口文档的编写至关重要，最好是写一个在线接口文档。接口文档能够方便团队查阅，减少不必要的沟通。如果对外公开api，api文档的质量直接反应了一个公司的技术水平，甚至一个公司的文化气质。

8.参考资料

本文参考了以下的资料:

豆瓣api

理解restful架构

restful introduction

跟着github学习restful api设计

REST接口设计规范

restful api 设计指南

扫码关注公众号有惊喜

（转载本站文章请注明作者和出处 方志朋的博客）

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

//bbs.csdn.net/topics/618658159)**

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！