一、什麼是 API？

在現代網路和應用程式的世界裡，經常會聽到 API（應用程式介面，Application Programming Interface）這個詞。API 其實是一組規範和規則，讓不同的程式之間進行溝通與操作。簡單來說，API 就像是一座橋樑，幫助兩個系統交換資訊，而不需要使用者親自操作。

舉個例子，當你使用天氣應用程式查看當前氣象時，這個應用程式並不是自己測量氣溫，而是向某個天氣數據提供商的 API 發送請求，然後接收該 API 回傳的最新氣象數據，顯示在你的手機或電腦上。這樣，你就可以輕鬆獲取最新天氣資訊，而不需要手動搜尋或測量。

二、生活與工作中的 API

API 在我們的日常生活與工作中發揮著重要作用，幫助我們簡化流程、提升效率。

生活應用範例

• • 外送平台：當你使用 Uber Eats 或 Foodpanda 訂購餐點時，應用程式會透過 API 連接餐廳的菜單系統、地圖服務（Google Maps API）計算配送時間，甚至與支付系統整合，讓整個過程更加順暢。

• • 智慧家庭：像是 Google Assistant 或 Apple HomeKit，它們透過 API 連接各種智慧家電，例如當你對 Siri 說「開燈」，HomeKit 會透過 API 讓智慧燈泡自動開啟。

• • 機票與飯店預訂：像 Skyscanner 這類的搜尋引擎會透過 API 即時獲取不同航空公司的票價與飯店資訊，幫助你快速找到最佳選擇。

工作應用範例

• • 專案管理：像 Trello、Notion、Asana 這類工具，都提供 API，讓企業可以將不同的系統整合。例如，當新的任務被指派時，API 可以讓 Slack 自動發送通知。

• • 數據自動化：企業經常需要整理數據，例如將 CRM（客戶管理系統）的資料同步到 Google Sheets 進行分析。透過 API，可以讓這個過程自動化，減少人工作業。

• • 雲端存儲：公司內部系統經常需要與 Google Drive、Dropbox 整合，讓文件上傳或存取變得更便利，這些都是透過 API 來實現的。

API 不僅提升了我們的生活便利性，也讓工作流程更加高效，減少手動操作，降低錯誤發生的可能性。

三、API 與 Notion 的應用 – 搭配 捷徑 App 輸入

透過 Notion API 來打造一個自動化的待辦事項系統，並結合 iPhone 的捷徑（Shortcuts）來讓整個流程更加順暢。

具體應用場景：當我透過捷徑輸入一個新的待辦事項時，這個任務會自動被寫入 Notion，並根據標籤分類到不同的區塊，例如「Meeting」或「Development」。

在請求 API 會需要使用到，會有 2 個要記下來的字串

• • 整合的密鑰（在第二步驟會取得，收好不要讓別人知道，如果真的不小心洩漏，後台可以重新刷新取得新的密鑰，請放心範例中的密鑰已經刪掉了～～）

• • Database 的 Id（在第五步驟會取得）

那就開始吧！！

1. 1. 申請 Notion 帳號並在 Notion 建立 工作空間(workspace)，這邊示範命名為 TODO。
      

      

1. 1. 於 Notion 的 Integration 網頁申請 ”整合(integrations)” 並複製 token (需要用網頁登入 Notion）。

      2.1. 透過 https://www.notion.so/profile/integrations 進到整合畫面並新增整合

      

      2.2. 為整合命名，工作空間選擇第一步驟建立的 TODO，類型用內部即可，選擇完後按儲存。

      

      2.3. 新增完後可以在畫面中取得密鑰，這是我們請求 API 的要素之一。

      

1. 1. Notion 建立 Database 並設定自己需求的屬性，這裡我加入 Done(Checkbox)、Name(Title)、Due Date(Date)、Category(Select)（格式：屬性（屬性類型），類型是什麼很重要，在設定請求 API 的內容時要寫得很清楚）。
      

      

1. 1. 串接第二個步驟在網頁上建立的整合（網頁版跟桌機的應用程式版本不知道為什麼沒有出現選項，我是用手機的 App 連接的）。

1. 1. 取得 database 的 id

      點擊 New 左邊的三個點點，有一個 Copy link to view。link 會長這樣 https://www.notion.so/1b8363f963b78045bf20fcb8da10ba8a?v=1b8363f963b7808eb887000ce198c5a8&pvs=4，我們只要 1b8363f963b78045bf20fcb8da10ba8a，這是 database id。這樣請求 API 的要素都拿到了，準備在 Apple 的 捷徑（Shortcut）做編輯。

      

1. 1. iPhone 或是 Mac 建立捷徑 （建議用 Mac 操作，因為 URL 會有參數要設定有點複雜用 Mac 會比較方便）

      成果展示：

      

      內容解釋：

      • • 前面三個輸入文字、日期、列表跟從列表中選擇可以在右側上方選項中的工序指令分類中找到；網址的部分從網頁分類中找到。
      • • 粉紅色的字是方便我們在輸入時看的文字，為了一致性都跟 database 定義的一樣，最後決定名稱的是設定 API 請求內容的名稱。
      • • 簡易介紹 API：我們使用 Create a page 這個 Notion 所提供的 API，可以在文檔中找到對應到捷徑的”取得 URL 內容“，標題中的 Authorization Bearer 後面的字串是步驟 2 得到的密鑰，要求內文中的 database_id 是步驟 5 得到的 database id。

          標題：

          Content-Type: application/json
          Authorization: Bearer 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
          Notion-Version: 2022-06-28

           

          要求內文：

          {
          	"parent":{
          		"database_id": "1b8363f963b78045bf20fcb8da10ba8a"
          	},
          	"properties": {
          		"Name": {
                "title": [
                  {
                    "text": {
                      "content": "變數(variable)"
                    }
                  }
                ]
              },
          		"Due Date": {
          			"date": {
          				"start": "變數(variable)"
          			}
          		},
          		"Category": {
                "select": {
                  "name": "變數(variable)"
                }
              }
          	}
          }

           

          補充：在填 Bearer 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 時貼上去會只看到 Bearer ，不是你貼錯，是字串太長了他自動換行，可以在那個輸入框按下即可看到其餘的內容；以及 Bearer 跟 密鑰之間一定要一個半形的空白。

      • • 要求內文中的 “變數(variable” 可以透過輸入筐點擊右鍵選擇 插入變數 > 選擇變數，此時畫面會顯示成 圖.插入變數-2 ，選擇欄位對應的變數。

          補充：在 圖.插入變數-2 中粉色字體代表的是上面項目的值，以 Category 為例，要選的是 https:api.notion.com/v1/pages 的這個選項，因為我填的分類存在這個項目裡面，這個項目的命名會自動抓下一個的名稱，所以長得比較奇怪，歡迎各大先見求解。

          

          

1. 1. 實際新增測試（我把捷徑加入到桌面，可以更方便的點擊觸發）

      7.1. 使用 iPhone 的 捷徑 新增

      7.2. 回到 Notion 查看狀況

      

這樣的自動化流程，無需手動開啟 Notion 來新增或分類事項，只要用快捷方式就能夠新增。我知道對於不太熟悉程式或是軟體相關操作的人對於到第六部就會很想要放棄，但是我非常鼓勵再多一點點的好奇跟興趣去完成它，甚至是只要先有 Name 這個屬性就好，完成的成就感真的很棒也很有趣。

此外還可以搭配 Notion Database – Calendar View 的呈現方式更直觀地看哪天要完成什麼事情。

可以再做優化的地方推薦～

• • 根據自己的需求加入屬性或是協作跟統計

• • 透過 Siri 口頭加入就不用手打了（懶到極致）

• • 現在 Notion 有辦法傳接 Google Calendar ，再把剛剛的 Todo List 整合就可以得到全部事情跟時間。

以及想要了解更多關於 Notion API 的話可以到 Notion Developer 查看他們寫的文檔。

💡 如果真的做不出來，這邊有現成的，只要填上 Authorization 跟 database_id 即可～ Shortcuts

四、結論

了解 API 不只是開發者的專利，而是每個人都應該具備的一點基礎知識，因為它可以大幅提升我們的生活和工作效率。當我們使用外送、銀行轉帳、社交媒體或企業應用時，API 都在背後默默地發揮作用，讓各種系統無縫整合，減少人為操作的時間。

在工作上，透過 API 可以將不同的工具和服務串聯起來，實現更高效的工作流程。例如，利用 Notion API 自動管理專案、整合日曆、發送通知，甚至分析數據，這些都能讓工作更加順暢，減少手動處理的負擔。

未來，隨著數位化的發展，尤其是 AI 的崛起以及 AI Agent 的整合，API 的應用將更加多元。然而，目前仍有許多技術尚未完全成熟，如果能夠掌握 API 的運用，就能夠自行串接各種服務，發揮其優勢，打造專屬於自己的高效工具。

掌握 API 相關的知識，不僅能夠提升個人效率，還能讓我們更聰明地運用科技，讓生活變得更便利。如果你還沒有開始學習 API，不妨從今天開始探索，它或許會為你的生活帶來意想不到的改變。