RESTful API
对于不同客户端,只提供一套服务的接口, REST是最好的选择。
分清几个概念
REST: Resource Representational State Transfer
Resource: 资源
Representational: 表现形式JSON、XML、JPEG。
State Transfer: 状态变换 通过HTTP动词实现(GET、POST、PUT、DELETE等)
RESTful: 符合REST原则
URI: Uniform Resource Identifier 统一资源标识符
URL: Uniform Resource locator 统一资源定位符
URN: Uniform Resource Name 统一资源名称
其中URL和URN是URI的子集。
目前主要使用的还是URL。
几个注意点
-------
版本
-------
可以将版本号直接加入到URL上:
https://api.example.com/v1/
也可以把版本信息加入到HTTP头信息中,[Github采用了这种方法](https://developer.github.com/v3/media/#request-specific-version)
--------------------
使用名词,推荐复数
--------------------
BAD:
/getProducts
GOOD:
/products
------------
HTTP动词
------------
GET(SELECT): 查找
POST(CREATE): 创建
PUT(UPDATE): 更新 (实际上这里相当于覆盖)
DELETE(DELETE): 删除
PATCH(UPDATE): 更新
两个不常用的
HEAD: 获取资源的元数据
OPTIONS: 获取信息,关于资源的哪些部分是客户端需要更改的。
实践
对于REST,楼主暂时还一知半解,就先带大家入个门(^_^),下面介绍比较实用的例子:
相信大部分做前端的同学,有时间对于没有接口数据而苦恼,有时间不得不在代码中加入一大段假数据。
是不是很苦恼。
的确,楼主也遇到了同样的问题。
今天,我们以一个优雅的方式解决
-------------
准备工作
-------------
1、首先确保你的电脑安装了Node
(也许说npm更贴切,前端的必备神器,现在有个yarn好像更6,是不是跑题了-_-).
2、安装json-server(可以看一下它的文档).
3、安装postman,也是个前端必备神器。专门用来调试接口的.
----------------
配置启动命令
----------------
1、在package.json文件的scripts中添加:
"server": "json-server --watch db.json",
----------
数据
----------
1、在项目根目录下建立db.json:
{
"students": [
{
"name": "xiaoming",
"age": 21,
"id": 1
},
{
"name": "xiaohong",
"age": 29,
"id": 2
}
]
}
-----------
操作
-----------
2、在命令行中输入: npm run server,
3、打开postman:
安装这个流程大家应该熟悉这套工具的使用了吧,以后再也不用为假数据操心了。