Restful 设计规范学习个人总结

Restful设计

参考：http://blog.jobbole.com/41233/

1、CURD

GET：获取资源

POST：增加资源

PUT：更新资源

DELETE：删除资源

2、Restful设计原则

2.1、简单

2.2、可读性好

2.3、使用名词，而不是动词

2.4、使用正确的英文单词

2.5、最好全部使用小写

2.6、一般使用复数，因为数据是很多的

2.7、多级的uri，尽量支持各个层级的uri都是有效的，例如：/a/b/c/{d}   则尽量让  /a /a/b /a/b/c /a/b/c/{d} 都是可用

3、HTTP状态码：

 200 ok  - 成功返回状态，对应，GET,PUT,PATCH,DELETE.
 201 created  - 成功创建。
 304 not modified   - HTTP缓存有效。
 400 bad request   - 请求格式错误。
 401 unauthorized   - 未授权。
 403 forbidden   - 鉴权成功，但是该用户没有权限。
 404 not found - 请求的资源不存在
 405 method not allowed - 该http方法不被允许。
 410 gone - 这个url对应的资源现在不可用。
 415 unsupported media type - 请求类型错误。
 422 unprocessable entity - 校验错误时用。
 429 too many request - 请求过多。