用點餐流程認識介面
跟業主說明介面時，我常把場景放在餐廳。點餐的人不會自己走進後廚，而是把需求交給服務人員；服務人員再轉告廚房，菜完成後送回桌邊。提出需求的一端像是呼叫方，負責處理的一端則像是伺服器。
API（Application Programming Interface，應用程式介面）就是那位傳話的人。它訂出兩套系統對話的規則，讓不同軟體交換資料與能力。在 無頭內容架構 裡，這層介面也是 前後端配合 時的主要通道。
企業接系統的理由
打破資料各自為政
經營者最容易忽略的，是多套工具各跑各的。網站、ERP、CRM、帳務與倉儲若互不相通，同一張訂單可能要人工鍵入好幾次。曾有工業材料商的會計每天多加班約兩小時補單；把這段人力換算進去，串接費用往往不到一年就能攤平。
接上之後，資料會自己往下走：訪客在網站下單，訂單寫入 ERP，庫存隨之更新，出貨通知也一併發出。
讓訪客少走冤枉路
- 來訪者可在頁面上直接查看倉庫存量
- 登入後能看到自己的配送進度
- 線上預約完成後，確認信與行事曆邀請自動送出
把重複勞動自動化
在系統之間手動搬資料，幾乎不創造價值。交給介面處理這些重複動作，人員才能把時間用在更值得判斷的工作上。
站點上常見的對接需求
線上收款整合
能在網路上收錢，是電商的起點：
- 卡號付款：例如綠界（ECPay）、藍新（NewebPay）
- 行動錢包：如 LINE Pay、Apple Pay、Google Pay
- 超商繳費代碼：由金流平台一併處理
這一段要特別守住安全：付款資料傳輸必須加密，並符合 PCI DSS。第一次接金流時，上線前應先釐清回呼重試與對帳；沒有對帳，金額遲早會出錯。
出貨配送整合
- 接上宅配通或黑貓介面，自動開立托運單
- 串接超商取貨（7-11、全家），自動取得寄件編號
- 在頁面上即時顯示包裹狀態
進銷存與 ERP 同步
讓網站上的訂單與客戶資料，和公司 ERP 保持一致：
- 成交訂單由網站直接送進 ERP
- ERP 存量即時出現在商品頁
- 價格與規格由 ERP 集中維護
客戶關係資料同步
頁面上的每次互動，都可能是一筆潛在生意：
- 聯絡表送出後，自動在 CRM 建檔
- 瀏覽過的商品一併回寫 CRM
- 依 CRM 分群，在網站上做不同推薦
社交管道連結
- 新文章自動同步到 Facebook 專頁
- 把 Instagram 近期動態嵌進網站
- 與 LINE 官方帳號的通知互相串連
Google 工具接入
- Google Maps：在聯絡頁放上地圖與路線
- Google Analytics：追蹤流量與使用行為
- Google reCAPTCHA：擋住自動程式亂送表單
- Google My Business：同步營業資訊與評價
郵件服務接入
- 透過 SendGrid 或 Mailchimp 寄出訂單確認、密碼重設等交易信
- 新訂閱者自動加入電子報名單
- 依使用者行為啟動一連串自動信件
對接前的核心觀念
REST 呼叫方式
這是目前最常見的介面風格。它使用標準 HTTP 方法：GET 讀取、POST 新增、PUT 更新、DELETE 刪除，內容通常以 JSON 傳遞。
身分驗證金鑰
多數外部服務會要求 API 金鑰來確認身分。可以把它想成入場會員卡：對方藉此辨認你是誰，以及允許你做哪些操作。
被動通知機制
一般查詢是你主動去問；Webhook 則是對方有結果時來通知你。例如付款完成後，金流服務會呼叫你登記的網址，告知某一筆已經入帳。
呼叫頻率上限
多數介面會限制單位時間的呼叫次數，例如每分鐘 60 次。設計時要把這個額度算進去，避免超量後被暫時拒絕。
先評估值不值得接
值得投入的場景
- 同一份資料要在兩套以上系統裡維護
- 有大量重複的人工搬資料工作
- 使用者需要立刻看到其他系統的資訊
- 流程必須跨系統自動完成：這類需求最能發揮 量身開發 的價值
可以暫緩的場景
並不是每個案子都該接介面。若只符合下面情況，通常不值得為此開發：
- 資料量小，人工處理比開發便宜
- 來源系統沒有對外介面，老舊軟體尤其常見
- 只是一次性搬移，用匯出再匯入即可
實作時的留意點
失敗與例外處理
外部服務不會永遠穩定。網路可能中斷、對方主機可能停擺、回傳格式也可能改變。可靠的串接至少要具備：
- 暫時失敗時自動重試
- 記錄每次失敗的細節
- 介面不可用時的替代做法
金鑰與傳輸防護
- 金鑰絕不能出現在前端程式裡
- 所有通訊都走 HTTPS
- 隔一段時間就更換新金鑰
- 只授予完成工作所需的最小權限
介面版本追蹤
服務方會更新版本。串接時要確認正在使用的版本，並留意對方公告，以免舊版停用後流程突然中斷。
重點回顧
把介面接上，是企業網站從展示走向營運的關鍵一步。網站不再只是線上名片，而能與核心系統一起工作。若想了解量身開發的長期效益，可參考 客製開發的長期好處。
評估時建議從最耗時的重複作業，以及客戶最想立刻掌握的資訊切入，報酬通常最高。正在規劃企業站的話，可先看 架站的完整步驟，再決定介面整合該排在哪個階段。
