作为 Web 开发人员，开发和调试 REST API 是家常便饭。我们会用一些工具来模拟 HTTP 请求，最常用的可能就是 Postman 了。前不久还冒出一个女版 Postman，那就是 Postwoman，详情可见我之前写的一篇介绍：还在用 Postman 测试接口？是时候试试 Postwoman 了！
这些工具确实很实用，但也存在一些局限性。
通过模拟 HTTP 请求来测试 REST API 是比较常见的做法，但是要编辑接口文档并进行版本管理，或者就是简单地跟团队成员共享，恐怕需要用到更多、更复杂的工具了。
有人说 Postman 付费版本就有这些功能呀。没错，但是要掏钱啊！本着能省则省的原则，有免费工具干嘛不用呢。再者，团队每个人都需要用 Postman 才行，我只想单纯写个代码，不想装那么多工具……
好了，大杀器即将出场。它就是 REST Client ！
REST Client 插件
REST Client 是一个 VS Code 插件.
装上它，你就可以在 VS Code 里发送 HTTP 请求，查看响应结果。这一切只需要一个文本文件，很容易加入到代码仓库中，方便版本管理。
优缺点
它主要的优势就是可以做版本管理和团队共享。
如果你在开发某个 API，你想让其他开发小伙伴们也知道怎么用你的接口，REST Client 就是个很好的帮手。
另外一个优势就是简单。前面说了，它只需要一个文本文件。它不但充当了发送请求的参数配置的角色，还可以作为接口文档，当你忘了某个接口怎么用的，直接翻出这个文件看看就行了！
缺点呢？那就是你要用 VS Code……作为 VS Code 铁粉，这根本就不是个事儿！当然，你要是用别的编辑器，那就……话说 VS Code 它不香吗？
用法
很简单，只要创建一个扩展名为 .http 的文件就行。比如要调用新浪股票的接口，我们新建一个stock.http文件：
@baseUrl = http://hq.sinajs.cn
GET {{baseUrl}}/list=sh600519
Accept: application/json
编辑完后，编辑器里会出现一个 Send Request 按钮，点击就可以发送请求了。请求结果会显示在右边的新 tab 里。是不是巨简单？
image.png
通常 REST API 不会这么简单，可能还有其它 POST，PUT，DELETE 等各种请求方法，还会需要请求参数或 Header 等。写法也很简单，其实跟浏览器开发工具里显示的差不多，只要遵循 RFC 2616格式要求，包含请求方法、header和 body 就行了。这里需要注意，header 内容要紧跟请求方法下一行，不能有空行，否则就是无效的。
POST https://example.com/comments HTTP/1.1
content-type: application/json
{
"name": "sample",
"time": "Wed, 21 Oct 2015 18:27:50 GMT"
}
进阶
实际项目中可能有更复杂的场景，比如要测试不同环境下的接口。为此，REST Client 提供了各种变量。变量分为两大类：自定义变量和系统变量。顾名思义，自定义变量就是用户自己定义的变量。它又分为环境变量、文件变量和请求变量。系统变量就是插件内置的一些变量，可以直接拿来用。具体用法可以参考官方文档。
举个例子，插件的环境变量是在 VS Code 的配置文件中定义的，也就是 settings.json文件：
"rest-client.environmentVariables": {
"$shared": {
"version": "v1",
"prodToken": "foo",
"nonProdToken": "bar"
},
"local": {
"version": "v2",
"host": "localhost",
"token": "{{$shared nonProdToken}}",
"secretKey": "devSecret"
},
"production": {
"host": "example.com",
"token": "{{$shared prodToken}}",
"secretKey" : "prodSecret"
}
}
这样，当你切换不同的环境时，就会启用该环境下的变量值。
插件的简单介绍就先到这里，更多功能可以查看插件的Github 仓库。
更多前端技术干货尽在微信公众号：1024译站
微信公众号：1024译站
网友评论