程式 什麼是API

API(Application Programming Interface)中文是「應用程式介面」是系統/程式依特定協議與外部構通的介面。

上面的解釋比較抽象可能不好理解，我們先了解Interface，也就是「介面」是什麼。介面簡單說就是和外部互動的東西，例如電腦的介面有螢幕、喇叭、鍵盤、滑鼠、USB插槽等；瀏覽器的介面有網址列、書籤、游標、功能選單、上一頁、下一頁、分頁等；購物網站的介面有登入頁、註冊頁、商品頁、商品搜尋欄位、購物車、下訂單、結帳頁等圖形操作介面(Graphic User Interface)，簡稱GUI。從上述的例子應該很好的解釋了介面是什麼，而這些介面互動的對象是我們人類，又稱為使用者或用戶(user)，所以稱為使用者介面(User Interface)。

所以應用程式介面的互動對象就不是人而是應用程式(application)，而應用程式通常在一個系統中運行，這也就呼應開頭的解釋。而應用系統在溝通時不是靠可操作的圖形，而是靠協議或協定，也就是規定那些資料該怎麼傳輸及產生什麼效果的規格書。

而現今提到API通常包括：1.程式內函式/函式庫API、2.網路應用程式API(Web API)。函式API是一個程式要如何去呼叫/使用特定函式的介面；而Web API是一個系統如何透過網路去使用另一個系統的介面。

例如下面是Java程式String.equals(Object anObject)方法/函式的API說明。

Compares this string to the specified object. The result is true if and only if the argument is not null and is a String object that represents the same sequence of characters as this object.
將這個字串與指定的物件進行比較。如果引數不為null（空）且是有相同字元序列的字串物件則結果為真(true)。

Overrides（複寫）:
  equals in class Object
  Object類別中的equals方法

Parameters（參數）:
  anObject - The object to compare this String against
  與此字串進行比較的物件

Returns（回傳）:
  true if the given object represents a String equivalent to this string, false otherwise
  如果給定的物件是同此字串的字串則為真(true)，反之為假(false)

例如下面是臺灣證券交易所 OpenAPI 1.0 - 最近上市公司的API，屬於Web API。

GET | openapi.twse.com.tw/v1/company/newlisting

• API和Endpoint差別？