「VSCode插件推薦」 REST Client: 也許是比Postman更好的選擇

在測試REST API的時候,想必大家都會有不同的工具選擇。如果是基於CLI的話,大家應該會選擇cURL。如果是GUI工具的話,相信很多人都會使用Postman。不過今天,筆者要推薦的是REST Client插件。也許,它是比Postman更好的選擇。

相比於Postman,REST Client支持了 cURL 和 RFC 2616 兩種標準來調用REST API。

RFC 2616

下面就是一個符合RFC 2616標準的POST請求

POST http://dummy.restapiexample.com/api/v1/create HTTP/1.1content-type:application/json{"name":"Hendry","salary":"61888",
"age":"26"
}

我們在VS Code新建一個以.http或者.rest結尾的文件,填入你的HTTP請求,點擊Send Request,或者右鍵選擇Send Request,或者直接用快捷鍵 Ctrl+Alt+R ,你的REST API就執行了,然後API Response就會顯示在右邊區域。是不是很方便?

「VSCode插件推薦」 REST Client: 也許是比Postman更好的選擇

cURL

下面是一個符合cURL標準的POST請求

curl -X POST "http://dummy.restapiexample.com/api/v1/create" -d "Hello World"

同樣地,也能通過REST Client在VS Code裡一鍵運行。

HTTP語言

REST Client 添加了HTTP語言的定義,支持把以 .http或者.rest結尾的文件當作HTTP語言,提供了語法高亮,代碼自動補全,代碼註釋等功能。

「VSCode插件推薦」 REST Client: 也許是比Postman更好的選擇

看到這裡,你也許會問,我直接用Postman在GUI上填一填REST API的各個字段不就行了,幹嘛還要寫一個HTTP的文件。其實直接有一個HTTP文件的最大好處,就是方便分享。比如說,你可以把HTTP文件文件放到GitHub,這樣的話,所有開發或者使用項目的人都能複用這個HTTP文件了。也極大的方便管理你的所有REST API。

更方便的是,通過###分隔符,同一個HTTP文件裡可以涵蓋多個HTTP請求。不像Postman,不同的HTTP請求需要放在不同的tab裡。

「VSCode插件推薦」 REST Client: 也許是比Postman更好的選擇

代碼生成

“代碼生成”也是REST Client裡一個很方便的功能,你可以方便地通過 Generate Code Snippet 命令來把HTTP請求生成出不同編程語言的代碼:JavaScript, Python, C, C#, Java, PHP, Go, Ruby, Swift等等主流語言。

「VSCode插件推薦」 REST Client: 也許是比Postman更好的選擇

高階功能

其實REST Client還有很多的功能,有需求的童鞋可以慢慢挖掘,筆者列出了一些比較有用的高階功能:

  • Authentication:REST Client支持了Basic Auth,SSL Client Certificates,Azure Active Directory等多種驗證機制
  • Cookies的支持
  • 支持 HTTP 3xx 的重定向
  • 變量的支持:環境變量,文件變量,預定義的系統變量等等

下面就是使用文件變量的一個例子,這樣在不同的HTTP請求中,變量就能共享了。其中,{{$datetime iso8601}} 是預定義的系統變量

@hostname =api.example.com
@port=8080
@host={{hostname}}:{{port}}
@contentType=application/json
@createdAt={{$datetime iso8601}}
###
@name=hello
GET https://{{host}}/authors/{{name}} HTTP/1.1
###
PATCH https://{{host}}/authors/{{name}} HTTP/1.1
Content-Type:{{contentType}}
{
"content":"foo bar",
"created_at":{{createdAt}}
}

哈哈!最後再給大家透露下:其實REST Client的作者也是中國人哦~ 曾經和筆者還是同事呢,是位大神哦!


分享到:


相關文章: