雖然有很多資料傳輸格式 (例如:XML),但 JSON 因為是源於 JavaScript 的物件語法,所以對瀏覽器 (Client) 來說,它原生、易於解析,而且可讀性高、檔案小。JSON 在 2000 年代初被普及,成為 Web API 的主流資料格式。
格式:JSON 是一種純文字的資料格式,使用鍵值對 (Key-Value Pair) 來儲存資料,非常類似 JavaScript 中的物件或陣列。
範例:
{
"name": "王小明",
"id": 101,
"isStudent": true,
"courses": ["網頁設計", "資料庫概論"]
}
寫好 endpoint 之後每次都要用 curl 來發送請求,測試程式有沒有寫對太麻煩了,因此有更好用的圖形化介面工具出現。
Yaak 是一套用於 API 測試的工具,畫面簡潔且開源,也是目前 SDC 開發部主要使用的工具。
Yaak – The API client you'll truly enjoy
接下來試著用圖形化介面發送在先前章節用 curl 測試過的 API request。
Request:
curl -i -X POST \\
-H "Content-Type: application/json" \\
-d '{"name": "Student A", "age": 20}' \\
<https://jsonplaceholder.typicode.com/posts>
畫面左上角可以新增一個 Request:

新增一個 Request
新增時需要選擇協定類型,我們使用的是 HTTP 協定:

選擇 HTTP 協定。
新增後可以看到一個空白的 Request,可依照需求設定。