REST与RESTFul
什么是REST
Representational State Transfer: 表述性状态转移
一种风格、约束、设计理念
通常来说,使用JSON描述数据
无状态
基于资源,增删改查都只是对于资源状态的改变
使用HTTP动词来操作资源
/getmovie/:mid (错误,不能用动词)
GET: /movie/;mid(正确,应该用名词)
RESTFul API最佳实践
@HTTP动词( 幂等性、资源安全性)
POST: 创建
PUT: 更新
GET:查询
DELETE: 删除
状态码:404、400、200、201、202、401、403、500
错误码:自定义的错误ID号
统一描述错误:错误码、错误信息、当前URL
使用Token令牌来授权和验证身份
版本控制
测试与生产环境分开:api.xxx.comdev.api.xxx.com
URL语义要明确,最好可以“望文知意
最好是有一份比较标准的文档
学习RESTFulAPI的最佳方式:模仿
豆瓣开放API
GitHub 开发者API
RESTFulAPI的合理使用(切勿盲目照搬标准REST)