經過這幾天的實際操作,
今天先把這一階段的書籍 API 學習內容做個總結。
一、從書籍 API 學到了什麼?
這幾天首先認識了 Open Library 的書籍搜尋 API,
知道可以透過 API 查詢公開的書籍資料。
接著實際使用 GET Request 進行查詢,
並透過 q 這個搜尋參數改變查詢的關鍵字。
例如搜尋:
Harry
Harry Potter
Potter
就可以觀察到不同搜尋條件所得到的結果。
在這個過程中,也重新接觸到前幾天學過的 JSON。
API 回傳的資料並不是單純的一個數值或一句文字,
而是由許多不同的資料組成。
其中可以看到 Array、Object、String、Number、Boolean 和 null 等不同的 JSON 資料型態。
之後再進一步觀察 Response,也可以看到像 numFound、q、docs 等不同欄位。
這讓我開始知道,
拿到一份 API 回傳的 JSON 後,
不只是「看資料」,
而是要知道每個部分代表什麼,
以及自己真正需要的是哪一部分。
二、把前面的概念串起來
這幾天的書籍 API 學習,
也剛好可以把前面學過的 Web API 基礎概念串在一起。
從使用網址送出 Request,
到 API 回傳 Response,再到閱讀 JSON 資料,
前面幾天學到的內容都實際出現在這次的操作中。
整個過程可以簡單整理成:
使用 Endpoint→加入搜尋 Parameter→送出 GET Request→API 回傳 Response→取得 JSON 資料→分析需要的內容
原本 Day 1 剛開始介紹 API 時,
只知道 API 是讓不同系統交換資料的一種方式。
到了這次實際操作後,
就比較能把這個概念和實際看到的資料連起來。
三、這次學習後的感覺
我覺得書籍 API 比較特別的地方,是可以很直接看到「輸入條件」和「回傳結果」之間的關係。
只要修改搜尋參數,API 回傳的內容也會跟著改變。
而且一開始看到 JSON 可能會覺得資料非常多,
但知道 Array、Object 等結構之後,
就可以開始找到資料的層級,
不需要把整份 Response 從頭看到尾。
這也讓我發現,
學習 API 除了知道怎麼發送 Request 之外,
如何閱讀 API 回傳的資料也是很重要的一部分。
四、總結
這一階段主要透過 Open Library 書籍 API,
實際了解了公開 API 的基本使用方式。
從一開始的 API 查詢,到搜尋參數的使用,
再到 JSON 結構和 Response 欄位的分析,
算是第一次完整地走過「送出 Request → 取得 Response → 閱讀資料」的流程。
雖然目前還沒有自己寫程式去處理這些資料,
但透過直接操作 API,也讓我對 Web API 的基本概念更加熟悉。
接下來會再舉下一個例子,
另一種大家平常也很常接觸到的資料——電影。
看看電影 API 能提供哪些資料,
以及和這次使用的書籍 API 有哪些不同。