背景

在學習Notion API的過程中，發現有兩種不同的方法分別為：

  • Query a database
  • Retrieve a database
    但就字面上的理解起來，兩個詞似乎都是要做一個「取得」的動作，那究竟有什麼差別呢？

說明

「Retrieve」和「Query」是API中常用的兩個術語，兩者都是用於描述向API請求數據的過程，其中

  • Retrieve：查詢
    • 通常指的是從API得到數據，而不是通過某種特定的方式進行篩選
    • 例如：直接取得所有數據、或者檢索特定ID的數據
  • Query：請求
    • 通過特定的方式向API發送請求，以獲取特定數據的過程
    • 例如：請求包含特定關鍵字的數據、請求特定日期範圍的數據

範例

Retrieve

假設有一個用於存儲用戶信息的API

GET /users/{user_id}

在這種情況下，正在检索特定用戶ID的用戶信息，因此可以稱其為「Retrieve」。

Query

假設需要在用戶信息API中检索具有特定年龄的所有用户

GET /users?age=25

在這種情況下，正在通過指定年龄向API發送查詢，以獲取特定數據，因此可以稱其為「Query」。