資料與 API詞條 1-56

API 端點API Endpoint

也常叫做：端點、API 路徑、Endpoint

你可能會這樣說

工程說明上寫著「呼叫 `/api/products` 取得商品」，你想知道這條路徑代表什麼。

API 端點是API 可以接收要求的具體網址，常見會用路徑表示，例如 /api/products 可能用來取得商品清單。完整呼叫通常還要知道要用哪個 HTTP 方法、帶哪些資料，以及是否需要登入。

API 是整套溝通方式，端點則是其中一個具體入口；同一個 API 通常有多個端點。

API

像一個服務窗口，定義外部程式如何提出要求。

端點

服務裡的一個具體入口，例如 `/api/products`，負責一類資料或功能。

圖 1-56　點上面的按鈕，看看各部分怎麼分工。

中文就可以

請用白話說明這個 API 端點：`GET /api/products`。告訴我它的路徑、用途和可能回傳的資料範例，不要假設我能存取未提供的服務。