「能不能幫我把網站的訂單，自動同步到我們的會計系統？應該不難吧？」
這是我接過最多次的需求，也是最常被低估的需求。客戶以為兩個系統都有 API，「接起來」就是寫個小腳本——實際上 80% 的時間都不是花在寫程式，是花在處理 API 的各種「沒寫在文件上的事」。
這篇拆給你看 API 串接真實的工程量，以及怎麼判斷你的需求是該客製、還是用 Zapier / Make 這類工具就夠。
API 串接到底在做什麼
「串接」這兩個字在客戶眼裡就一條線。在工程師眼裡，是這六件事：
- 認證：怎麼證明你有權限存取對方的 API？OAuth、API Key、HMAC 簽章？token 過期怎麼自動換新？
- 資料映射：A 系統的「客戶名稱」對應 B 系統的哪個欄位？日期格式、貨幣單位、ID 規則一不一樣？
- 錯誤處理：對方 API 掛掉怎麼辦？網路斷線怎麼辦？資料格式突然變了怎麼辦？
- 速率限制：對方一分鐘只允許 60 次 request，你今天有 500 筆訂單怎麼辦？
- 同步策略：即時同步、每小時批次、還是定時補拉？同一筆資料同步兩次會不會重複？
- 日誌與監控：哪一筆同步失敗了？你怎麼知道？怎麼補救？
簡單講就是：寫核心邏輯只需要一天，把上面六件事處理好需要兩週。客戶看的是「功能能不能跑」，工程師看的是「半年後系統還在不在跑」。
三種 API 友善程度
不是所有 API 都長得一樣。我把過去接觸過的分三類：
一級友善：文件齊、SDK 完整、有 webhook
代表：Stripe、Shopify、Slack、Google Workspace 系列、Notion、Anthropic、OpenAI
這類 API 接起來相對單純。文件一頁清楚、官方有 SDK、有 webhook 可以即時通知（不用你定時拉資料）、錯誤訊息看得懂。一個熟練的工程師通常 2-5 天能做完一個典型整合。
二級堪用：有文件但不夠新、SDK 部分支援、要自己做事件輪詢
代表：大多數台灣本地 SaaS、部分國際小眾工具、ERP 系統的對外 API
文件存在但常常落後一兩個版本，SDK 有但只 cover 部分功能，沒有 webhook 所以你要自己定時去拉。會花時間是因為——文件寫的跟實際 API 回傳的不一定一樣，你要自己一個一個試。一個整合做下來常常 1-3 週，主要時間花在「除錯」而不是「寫」。
三級地獄：沒有文件、要逆向工程、隨時可能變
代表：銀行金流（部分）、政府系統、爬蟲（其實不是 API 但同樣痛苦）、十年沒更新的舊系統
這類我會直接跟客戶說：「這不是『串接』，是『開發』。預算和時程要分開估。」做這種整合最麻煩的不是技術，是「對方半年後改一個欄位你的系統就壞了」——你要設計一套監控機制隨時知道掛了，並且要有預算修。
什麼時候該客製、什麼時候 Zapier 就夠
很多客戶以為自己需要客製 API 串接，其實 Zapier、Make（前 Integromat）、n8n 就能解決。我的判斷標準：
用 Zapier / Make 就夠的情況
- 同步邏輯簡單：A 發生 → B 做某事
- 兩邊系統都在 Zapier 支援列表裡
- 每月觸發次數在 1,000 次以下
- 沒有複雜的資料轉換（不需要查找、計算、條件分支）
例子：「客戶在 Shopify 下單後，自動寄一封感謝信並加入 Mailchimp 名單」——這用 Zapier 半小時設完，每月成本約 NT$ 600-1,500。沒必要花 5 萬請人寫。
應該客製的情況
- 某一邊系統不在 Zapier 支援列表（很多台灣 SaaS、自家 ERP、舊系統）
- 觸發頻率高（每月幾萬筆以上 Zapier 會貴到不划算）
- 需要複雜資料轉換或業務邏輯
- 需要嚴格的錯誤重試、稽核日誌
- 資料含敏感資訊，不想經過第三方
例子：「ERP 出貨資料每天同步到官網的訂單狀態，並透過 LINE 通知客戶」——ERP 多半不在 Zapier，每天上千筆，要對照客戶 ID 查找，需要客製。報價約 NT$ 80,000-150,000。
一個真實案例的成本拆解
舉一個我做過的案子（細節微調過）：客戶要把蝦皮、Shopify、實體 POS 的訂單，每天同步到 Excel 報表寄給會計。
聽起來很單純，實際上：
| 項目 | 工時 |
|---|---|
| 蝦皮 API 認證（沒有官方 SDK，文件中文翻譯不完整） | 1.5 天 |
| Shopify API 接（這個快，半天） | 0.5 天 |
| POS 系統匯出（沒有 API，要爬後台 CSV） | 1 天 |
| 三邊資料格式統一（欄位名稱、日期、商品 ID 都不一樣） | 1.5 天 |
| 排程 + 寄信邏輯 | 0.5 天 |
| 錯誤通知機制（哪一邊掛了要 LINE 通知老闆） | 0.5 天 |
| 測試（連續跑 3 天確認資料對） | 1.5 天 |
| 文件 + 交接 | 0.5 天 |
總計 7.5 天。報價約 NT$ 60,000。客戶第一次聽到的反應是：「不就是把資料抓出來嗎？」
但真正讓客戶後來覺得值得的，是上線後第三週發生的事——蝦皮改了一個 API 欄位名稱，原本的整合掛了。因為一開始就有監控機制，老闆 30 分鐘內收到 LINE 通知，我們 2 小時內修好。沒有監控的話，可能是月底會計來問「為什麼這個月帳對不起來」才發現，那時候已經漏了三週的資料。
怎麼跟工程師談 API 串接
如果你要找人做整合，問他這幾個問題就能判斷靠不靠譜：
- 「這兩個系統的 API 你有實際用過嗎？」——沒用過的話估時要打 1.5 倍
- 「掛掉的時候我怎麼知道？」——有設計監控的工程師會直接回你，沒設計的會說「不會掛」
- 「對方 API 改了你會收費修嗎？」——這個要寫在合約裡，不然你會吃虧
- 「資料對不齊的時候怎麼辦？」——這個答得出來的，是真的做過整合的
簡單講：「能不能做」每個工程師都會回「能」；「半年後還在跑」就見真章了。
如果你手上有兩個系統想串起來不確定怎麼做，寫信給我們聊 15 分鐘。我會直接告訴你——是 Zapier 半小時的事、還是真的需要客製，以及客製的話該怎麼設計才不會三個月後就壞。