什麼是API

API 應用程式介面 也就是 Application Programming Interface 的縮寫

這裡有不錯的影片讓你可以簡單的瞭解API

資料來源

如果沒空看影片這邊用文字簡略的說

網路上有存取很多資料的伺服器

而我們可以透過API 向那些伺服器 拿取資料 更近一步可以存取資料甚至可以操作那些資料

API就是我們操作那些資料的媒介

何謂 Airtable

Airtable 是一個雲端資料庫 就像是一個線上Excel 可以彙整各種資料

並可以透過API 對裡面的資料進行操作 進一步 取得或是修改相關資料

1. 先從Airtable的介面點選右上角的Help叫出 Help選單

2. 再點選最下面的API documentation(API 文檔)，叫出API操作說明

3. 選擇你要的操作的Table，展開該Table的細部選項

• List records -- Get所有資料(並可以透過資料參數選擇要Get的資料細項)
• Retrieve a records -- Get單筆資料(透過ID選取要Get哪筆資料)
• Create a records -- 在資料庫上添加一筆資料
• Update records -- 將資料庫上的資料全部更新
• Delete records -- 刪除資料庫上特定一筆資料(透過ID去選擇)

4. 這裡示範 做資料串接 所以選擇 List records

5. 要使用API需要驗證身分，所以他給的示範code 上面都會有 YOUR_API_KEY，要使用這些code需要點選右上角的"show API key" 讓示範code嵌入你的API-key

6. 複製下面的示範code

7. 將複製下來的示範code貼到終端機(CMD)上測試，看看這個API code是不是能正常運作

8. 確認測試結果是不是你要取得的資料

9. 延伸 如果不選curl 選JavaScript 你需要 先引入airtable.js檔後，才能用JavaScript操作

接下來我們需要借助postman這個軟體來處理拿來下的code讓他轉成JavaScript可以操作的樣子

postman是一個協助你操作API的軟體，安裝部分就不贅述了

1. 打開postman介面，選擇My WorkSpace，進入工作平台

2. 點選import，準備匯入要先前複製的code

3. 選擇匯入的種類，現階段我們使用的是Raw text

4. 將剛剛複製的code貼上，並點選右下角的Continue(圖上忘記畫上去)

5. 確認資料沒問題後點擊Import(匯入)

6. 調整參數--將數量限制拿掉(這邊還可以增加參數，去篩選獲得的資料)

7. 將資料送出

8. 檢查拿到的是不是你要的資料

9. 選右上角的</>拿取經過postman轉換過的程式碼

10. 選擇輸出程式碼的形式，這邊我使用JavaScript-Fetch

11. 點擊右上角的複製鍵

12. 在瀏覽器中測試

13. 確認是否是你要的資料

14. 將輸出資料的形式改成JavaScript能使用的json檔

這之後是作者目前使用的方式，不一定是最適當的，可能以後會變

15. 宣告一個參數來接收取得的資料

16. 將這些取得的資料賦予給剛剛宣告的參數

延伸 資料庫的資料超過100筆 後端分頁的處置

當資料超過100筆的時候會因為後端分頁的限制，沒辦法一次取得，這時候取出來的資料會在多一個屬性offset

1. 當資料超過100筆的時候，資料的最後面會多一個屬性offset

2. 將offset的屬性跟他的值放進，API的參數裡面，送出就能取得後100筆的資料了

2022.12.05 更新錯字及影片連結

參考資料

Airtable
Postman