
API 串接,就是讓兩套系統用事先講好的格式自動交換資料:訂單成立時電商後台自動把資料丟給 ERP,付款成功時金流商自動通知你的系統,發票開好時財政部平台自動收到上傳。做一條串接要花多少錢,關鍵在對方的 API 好不好接、資料要多準、出錯時要多快知道,跟「要接幾個欄位」關係反而不大。
我們在客製化系統開發的諮詢裡,最常聽到老闆或 PM 說的一句話是:「兩邊都有系統了,接起來應該很快吧?」接下來的對話通常會停在三個問題:對方真的有開 API 嗎、測試環境在哪、出錯了誰負責。這篇就是把那三個問題攤開來講,讓第一次發包串接案的人,在找廠商之前就知道要問什麼。
如果你對 API 這個詞本身還很陌生,可以先看 API 是什麼?為什麼老闆也該懂這個技術名詞;想看整體架構怎麼選(點對點、中介層、iPaaS),可以搭配 系統整合是什麼。這篇只專心處理一件事:兩套系統之間的那一條線,怎麼接、怎麼估、怎麼驗。
先看一個數字。MuleSoft 2025 年的 Connectivity Benchmark 報告訪問了 1,050 位企業 IT 主管,企業平均用 897 套應用程式,彼此連得起來的只有 29%,95% 的受訪者說跨系統整合資料有困難。大企業都卡在這裡,中小企業手上那幾套系統沒接起來,再正常不過。
API 串接是什麼:用餐廳點餐員講一次就懂
一句話:API 是系統對外開的點餐窗口,串接就是派一個點餐員在兩個窗口之間跑腿。
想像你的電商後台是一間餐廳的外場,ERP 是另一間餐廳的廚房。客人在外場點了一份餐(下了一張訂單),點餐員要拿著單子走到廚房窗口,用廚房看得懂的格式報菜名(API 規格),廚房回一句「收到,單號 A123」(回應)。如果廚房說「這道菜今天沒有」(錯誤),點餐員要知道該回頭告訴外場,還是等五分鐘再問一次。
串接工程師寫的,就是這個點餐員的腦袋:什麼時候出發、帶什麼資料、用什麼格式講、聽到什麼回應該怎麼辦。窗口(API)是對方開的,你能決定的只有點餐員有多聰明。下面這張表先把整篇的答案濃縮起來,趕時間的人看這張就夠。
你想問的事 | 短答案 | 細節在哪一段 |
|---|---|---|
API 串接到底在做什麼 | 讓兩套系統自動交換資料,取代人工複製貼上與匯出匯入 | 本段 |
一條串接由哪些零件組成 | 驗證、欄位對應、觸發方式、錯誤處理、監控,五樣缺一樣都會出事 | 一條串接裡面有哪些零件 |
台灣最常接的是哪些 | 金流、物流、電子發票、LINE、ERP/進銷存、電商平台與 POS | 常見串接情境 |
費用怎麼估 | 看對方 API 品質、資料量、同步方向、錯誤處理要求、監控要求 | 費用怎麼估 |
發包前要做什麼 | 先問清楚對方系統的 7 件事,答不出來的先別簽 | 發包前先問對方的 7 件事 |
最常見的坑 | API 改版沒通知、呼叫太快被限流、金鑰外洩 | 三個最常踩的坑 |
自己用 n8n 接還是找人寫 | 一條單向、量小、出錯可以等,自己接;要雙向、要對帳、要稽核,找人寫 | 自己接還是找人寫 |
一條 API 串接裡面有哪些零件
先講結論:真正花時間的通常是「出錯的時候怎麼辦」,正常流程反而只占一小部分。很多報價差三倍,就差在這一塊有沒有算進去。
一條能放心交給它每天跑的串接,至少要有五個零件。少一個不會馬上壞,但會在某個月底對帳時,突然發現少了 37 筆訂單。
零件 | 它在做什麼 | 沒做會怎樣 |
|---|---|---|
驗證(Authentication) | 證明「我是誰、我有權限呼叫你」,常見是 API Key、OAuth、簽章 | 金鑰寫死在程式裡,離職工程師也能用;或權限開太大,一支金鑰能刪全部資料 |
欄位對應(Mapping) | 把 A 系統的「客戶編號」翻成 B 系統的「customer_code」,單位、幣別、日期格式一起換 | 電商的含稅價進了 ERP 變未稅價,或日期時區差 8 小時,月結全部對不上 |
觸發方式 | 定時去拉(Polling)或對方有事主動通知(Webhook) | 每 5 分鐘拉一次撞到呼叫上限;或 Webhook 沒收到也沒人知道 |
錯誤處理與重送 | 對方回錯誤、逾時、網路斷線時,要重試幾次、隔多久、重送會不會重複建單 | 同一張訂單在 ERP 出現兩次,或失敗的那筆永遠消失 |
監控與通知 | 每天成功幾筆、失敗幾筆,失敗時誰收到通知 | 串接壞了三天,業務被客戶追問才發現 |
觸發方式值得多講一句。Polling 像是每隔幾分鐘打電話問廚房「好了沒」,簡單但浪費;Webhook 像是廚房做好主動按鈴,即時但要準備一個隨時有人顧的收件窗口。金流付款成功、LINE 收到訊息這類「對方先知道」的事件,幾乎都用 Webhook;ERP 庫存這類「我想看的時候再問」的資料,多半用定時拉。
錯誤處理則是最容易被省掉的一塊。舉個實際的例子:LINE 官方在 重送 API 請求的說明裡寫得很直白,回 500 或逾時的請求「有可能其實已經送達」,直接重送會讓客人收到兩則一樣的訊息,所以他們提供一個重送用的識別碼,同一個識別碼 24 小時內只會執行一次。這種「重送不會重複」的設計叫冪等(idempotency),金流、訂單、發票這種跟錢有關的串接,沒有它就不該上線。
這件事我們自己也碰過。恆遠自家的幾個產品共用一套會員中樞,每個產品都要透過同一支授權查詢 API 問「這個人有沒有訂閱、權限到哪天」(恆遠會員中樞系統)。我們刻意把「身分與訂閱」跟各產品的業務資料拆開,中樞只管 user_id 與訂閱狀態,各產品自己存業務資料,所以一個產品出問題不會拖垮其他產品,新產品上線時接這支 API 就有完整的會員基礎。你的情況如果也是好幾套系統都要問同一份資料,可以跟我們聊聊,我們可以先幫你看拆法適不適合。
台灣最常見的六種 API 串接情境
先講結論:金流和電子發票的 API 最成熟、文件最完整,通常最好接;ERP 和老舊 POS 最難,因為很多根本沒有對外 API,要先確認能不能接,才談怎麼接。
情境 | 常見對象 | 對方通常給什麼 | 最容易卡的地方 | 延伸閱讀 |
|---|---|---|---|---|
金流 | 綠界、藍新、TapPay、Stripe | 完整 API 文件、測試環境、付款結果通知(Webhook) | 付款通知收不到或重複收到、退款與對帳 | |
電子發票 | 財政部平台(Turnkey)或加值中心 | 規格文件、測試帳號 | 格式版本升級、作廢與折讓流程 | |
LINE | LINE 官方帳號 Messaging API | Webhook、推播 API、呼叫上限說明 | 推播額度與費用、呼叫太快被限流 | |
ERP/進銷存 | 鼎新、正航、SAP B1、Ragic 等 | 看廠商,有的有 API,有的只能匯出檔案或直接讀資料庫 | API 要另外付費開通、欄位定義只有原廠顧問知道 | |
電商平台與 POS | Shopline、91APP、蝦皮、各家 POS | 開放程度差很多,部分要申請合作夥伴資格 | 只給讀不給寫、訂單狀態定義跟你的不一樣 | |
工廠與生產系統 | MES、報工系統、設備資料 | 多半要客製,設備端由設備商負責 | 主檔誰說了算(料號、BOM、工單) |
表上最右邊那欄是同一系列的延伸文章。每一種情境都有自己的眉角,例如金流最怕「付款成功了但你的系統沒收到通知」,客人付了錢訂單卻顯示未付款;電子發票則是格式版本會跟著財政部規範走,後面講坑的時候會再提。
ERP 那一列特別容易誤判。很多老闆以為「我們的 ERP 很大套,一定有 API」,實際問原廠才知道 API 模組要另外買授權,或只開放讀取不開放寫入。所以 ERP 串接一定是先問原廠、再找開發廠商,順序反過來,報價會一直變。
API 串接費用怎麼估:五個讓報價翻倍的變數
先講結論:同一條「訂單從電商進 ERP」,報價差好幾倍很正常,差在下面五個變數,跟欄位數量關係不大。想看計費模式(按人月、按 endpoint、固定總價)與合約紅線,可以接著看 SaaS 接口整合費用拆解與 企業 API 整合外包採購指南,這裡只講「什麼東西會讓工時變多」。
變數 | 便宜的情況 | 貴的情況 |
|---|---|---|
對方 API 品質 | 有公開文件、有測試環境、錯誤訊息講得清楚 | 沒文件、只能問原廠窗口、錯誤一律回「系統錯誤」 |
同步方向 | 單向:A 寫進 B 就好 | 雙向:兩邊都能改,要處理衝突與誰說了算 |
資料量與即時性 | 一天幾十筆、晚一小時沒關係 | 尖峰一分鐘上千筆、要即時,還要排隊與限流控制 |
錯誤處理要求 | 失敗了寄信通知、人工補 | 自動重試、不能重複建單、每天自動對帳出差異報表 |
監控與稽核 | 看 log 就好 | 要儀表板、要保留誰在什麼時間改了什麼的紀錄 |
以我們看過的串接需求來說,最常被低估的是第二項和第四項。單向串接只要把資料送過去;雙向串接要先決定「同一個欄位兩邊都改了,聽誰的」,這一題沒想清楚,上線後會出現兩邊互相覆蓋、資料來回跳的狀況。
第四項則跟錢最有關係。訂單、付款、發票這種資料,少一筆或多一筆都會在月底爆出來,所以要求「重送不重複」與「每天自動對帳」是合理的,只是這兩件事的工時,常常比正常流程還多。報價單上如果只寫「訂單同步 1 支」,沒寫錯誤處理和對帳,比價時要問清楚有沒有算進去。
還沒找廠商前可以先做的事
把要接的兩套系統名稱、版本、管理員是誰、每天大概幾筆資料、哪些欄位要過去、出錯時希望誰收到通知,寫成一頁紙。這一頁拿去問任何一家廠商,報價都會準很多。想直接把這一頁丟過來討論,也可以 加 LINE 跟我們聊。
發包前先問對方的 7 件事
先講結論:這 7 題是問「被串接的那一方」,也就是金流商、ERP 原廠、電商平台或對方公司的 IT。答案拿到了,開發廠商才估得準;答不出來的題目,就是報價會追加的地方。
要問開發廠商的問題(計費模式、交付物、驗收)是另一份清單,API 整合外包採購指南整理了 12 題,兩份可以搭配用。
有沒有公開的 API 文件,開通要不要另外付費
先要到文件,再談其他。好的文件會寫清楚每支 API 的網址、要帶什麼參數、回什麼格式、錯誤代碼代表什麼。只給一份 PDF 範例、說「有問題再問我們窗口」的,代表開發期間每卡一次就要等對方回信,工期會被拖長。同時要問:API 功能是不是要額外買模組或月費,這筆錢常常沒有出現在任何一方的報價單上。
有沒有測試環境
測試環境(sandbox)讓你可以隨便下假訂單、刷假卡、開假發票,不會動到正式資料。金流和電子發票通常都有;ERP 和老舊系統常常沒有,只能在正式環境測。如果只能在正式環境測,要事先講好測試資料怎麼標記、測完怎麼清,不然測試訂單會混進月報。
驗證方式是什麼,金鑰由誰保管
問清楚是 API Key、OAuth 還是簽章,金鑰有沒有期限,能不能一個系統一把、權限分開。接著問內部:金鑰由誰申請、存在哪、工程師離職時怎麼換。金鑰最好開在公司的帳號底下,不要開在外包工程師的個人帳號,不然合作結束時,連「換一把新的」都要拜託對方。
呼叫上限是多少,超過會怎樣
幾乎所有 API 都有呼叫上限(rate limit),例如每秒幾次、每天幾次。LINE 官方今年 9 月發的 技術文章就用水桶比喻解釋他們的限流方式:短時間爆量可以先用掉桶子裡存的額度,桶子空了就會收到 429 錯誤。你要知道的是自己的尖峰量(例如雙 11 當天一小時幾張單)會不會超過,超過時是排隊慢慢送,還是直接丟掉。
改版怎麼通知,舊版會留多久
API 會改版,這是一定的。要問的是:改版前多久通知、通知寄給誰、舊版會並行多久。財政部的 電子發票應用 API 規格從民國 100 年初版到 112 年的 1.9 版,修訂表列了十幾個版本,其中包括簽章演算法升級成 HMAC-SHA256、移除 GET 傳輸方式這種一改就不相容的變動。政府平台都會公告,民間小廠商就不一定了。
出錯時回什麼,重送會不會重複
請對方提供錯誤代碼清單,並問一句:同一筆資料送兩次,會建兩筆還是認得出是同一筆?有提供冪等機制(例如帶一個唯一識別碼)的 API,重送很安全;沒有的話,開發端要自己記錄「這筆送過了沒」,工時會多出來。
這份資料以哪一邊為準
客戶資料以 CRM 為準還是 ERP 為準?庫存以倉庫系統為準還是電商後台為準?這題要內部先吵完,再告訴開發廠商。沒有答案的雙向同步,等於叫兩個人同時改同一份 Excel。
把 7 題的好答案與警訊整理成一張表,開會時可以直接拿來對:
問題 | 聽到這個可以放心 | 聽到這個要小心 |
|---|---|---|
API 文件 | 有線上文件、有範例、有錯誤代碼表 | 「有問題再問我們」、只有一份舊 PDF |
開通費用 | 開通流程與費用寫在官網或合約 | 「要問業務」、要另外簽年約 |
測試環境 | 有 sandbox,測試帳號可自助申請 | 只能在正式環境測 |
驗證與金鑰 | 可以一個系統一把、可設權限與期限 | 全公司共用一組帳密 |
呼叫上限 | 有寫明數字,超過回明確錯誤 | 「應該夠用」、沒寫 |
改版通知 | 有公告頁、舊版並行一段時間 | 「我們改了會跟你說」 |
錯誤與重送 | 有錯誤代碼、有冪等機制 | 錯誤一律回 500 |
API 串接最常踩的三個坑:改版、限流、金鑰外洩
先講結論:這三個坑上線那天都不會出現,都是上線後幾個月才爆。所以驗收時就要把「它們發生時會怎樣」一起測。
API 改版:某天早上突然全部失敗
最常見的劇本是:對方把某個欄位從選填改成必填,或把舊版網址關掉,你這邊的串接從某天早上開始全部回錯誤,但沒有人收到通知,直到客服接到第一通抱怨電話。前面提到的電子發票 API 規格就是例子,修訂表一路從欄位調整、服務網址變更改到簽章演算法升級,每一次都要有人跟上。
防法有兩個:一是改版通知要寄到「一個不會離職的信箱」,例如 IT 共用信箱;二是監控要能在失敗率突然升高時馬上通知,不要等人發現。
限流:促銷那天最需要它的時候它最慢
平常一天一百筆單,串接跑得好好的;檔期當天一小時三千筆,API 開始回 429(太多請求),訂單塞在半路。對方系統其實正常,只是你超過了它給的額度。解法是在自己這邊加一個排隊機制(佇列),送不過去的先排著,依對方的速度慢慢送,而且每一筆都要能追蹤送了沒。
金鑰外洩:寫在程式碼裡的密碼
GitGuardian 的 2025 年機密外洩報告統計,2024 年一年就在 GitHub 公開程式碼裡找到約 2,380 萬組新外洩的金鑰與密碼,比前一年多 25%,報告也發現,2022 年外洩的金鑰到報告發布時仍有七成可以用。API 金鑰一旦外洩,別人就能用你的名義查訂單、發推播、甚至退款。
最基本的做法是:金鑰放環境變數或密鑰管理工具,不寫進程式碼;每個系統用自己的金鑰;人員異動就換。規模大一點的團隊可以參考 企業機密管理工具採購指南。
我們的看法比較直接:串接案最該花錢的地方是監控和錯誤處理,介面反而可以陽春。很多案子把預算花在漂亮的同步設定畫面,結果出錯時沒人知道。一條串接好不好,要看它壞掉時多快被發現、能不能自動補回來。
API 串接要自己用 n8n 接,還是找人寫程式
先講結論:一條單向、量小、出錯晚一點處理也沒關係的串接,用 n8n、Make 這類工具自己接很划算;要雙向同步、要對帳、要稽核紀錄、或跟錢有關,找人寫程式比較穩。工具的比較可以看 n8n vs Make vs Zapier。
你的情況 | 建議做法 | 原因 |
|---|---|---|
表單送出後通知 LINE 群組、寫進 Google Sheet | 自己用 n8n 或 Make | 單向、量小、失敗了重送一次就好 |
LINE 收訊息後自動回覆、轉給業務 | n8n 起步,訊息量大或流程複雜再改寫 | 可以先驗證流程,再決定要不要投資 |
電商訂單進 ERP、扣庫存 | 找人寫,或 n8n 搭配專人維護 | 雙向、跟錢有關、要對帳 |
付款結果更新訂單狀態 | 找人寫 | 要驗簽章、要冪等、不能漏 |
三套以上系統互相傳資料 | 找人規劃中介層 | 點對點會變成蜘蛛網,改一套牽動全部 |
最後一列值得解釋。兩套系統接一條線,三套就可能變三條,五套最多十條,每一條都有自己的格式和錯誤處理,改一套系統要動好幾條線。這時候比較好的做法是中間放一個中介層,大家都只跟中介層講話,細節可以看 自建中介層 vs 買 iPaaS。
發包時,合約裡記得寫進三件事:串接的範圍(哪幾支 API、哪些欄位、單向還是雙向)、錯誤處理與監控的驗收標準、對方 API 改版時的維護方式與費用。條款怎麼寫可以參考 軟體開發合約範本。
看到這裡,如果你已經有兩套系統要接,但不確定對方 API 能不能用、該自己接還是找人寫,我們很樂意 聽你聊聊現在的情況,先幫你看值不值得做、怎麼做最划算。
ℹ️我們怎麼看
接下來幾年,台灣中小企業的系統只會越來越多,API 串接會從「專案」變成「日常維運」,就像水電管線,裝好之後每年都要檢查。Postman 的 2025 年 API 現況報告裡,有 82% 的組織說自己某種程度上已經是「API 優先」,代表你接的對象會越來越常改版、越來越常加新功能。我們的取捨是:寧可少接一條,也要每一條都有監控和重送機制。給讀者的判斷方式很簡單:拿出你目前最常人工搬資料的那一段流程,算算每個月花幾小時、出錯過幾次,數字夠大再接,先從那一條開始。
ℹ️我們做過這件事
QAPI 串接是什麼?
API 串接是讓兩套系統透過事先定義好的格式自動交換資料,例如電商訂單自動進 ERP、付款成功自動更新訂單狀態、發票自動上傳財政部平台,用來取代人工複製貼上與匯出匯入。
QAPI 串接要多久?
看對方 API 的品質與同步方向。對方文件完整、有測試環境、單向同步的串接,開發時間相對短;要雙向同步、自動對帳、或對方沒有測試環境,時間會明顯拉長。發包前先問清楚對方系統的 7 件事,估出來的工期會準很多。
QAPI 串接費用怎麼算?
主要看五個變數:對方 API 品質、單向或雙向、資料量與即時性、錯誤處理要求、監控與稽核要求。欄位數量影響反而不大。計費模式與合約紅線可以參考我們的 SaaS 接口整合費用拆解一文。
Q對方系統沒有 API 還能串接嗎?
有機會,但做法會變成檔案交換(定時匯出匯入 CSV)、直接讀資料庫,或請原廠另外開放 API。這幾種做法都比正式 API 脆弱,對方系統一更新就可能失效,簽約前要把維護方式講清楚。
QAPI 金鑰要怎麼保管?
金鑰不要寫進程式碼,放在環境變數或密鑰管理工具;每個系統用自己的金鑰並限制權限;金鑰開在公司帳號底下,人員異動時更換。外包合作結束時,也要把金鑰換掉。
Q用 n8n 做 API 串接可以嗎?
單向、量小、出錯可以晚點處理的串接,用 n8n 很划算。跟錢或庫存有關、要雙向同步、要稽核紀錄的串接,建議找人寫程式,或至少由專人維護 n8n 流程並加上監控。
AUTHOR
恆遠數位編輯團隊






留言(0)
尚無留言,成為第一個留言的人吧!