API 串接是什麼?兩套系統怎麼接、費用怎麼估,發包前先問對方的 7 件事

恆遠數位編輯團隊約 14 分鐘閱讀
API 串接封面:兩套系統怎麼接、費用怎麼估與發包前先問對方的 7 件事
複製引文

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、呼叫上限說明

推播額度與費用、呼叫太快被限流

n8n 串 LINE 怎麼做

ERP/進銷存

鼎新、正航、SAP B1、Ragic 等

看廠商,有的有 API,有的只能匯出檔案或直接讀資料庫

API 要另外付費開通、欄位定義只有原廠顧問知道

LINE 訂單怎麼串 ERP

電商平台與 POS

Shopline、91APP、蝦皮、各家 POS

開放程度差很多,部分要申請合作夥伴資格

只給讀不給寫、訂單狀態定義跟你的不一樣

POS 系統推薦怎麼挑

工廠與生產系統

MES、報工系統、設備資料

多半要客製,設備端由設備商負責

主檔誰說了算(料號、BOM、工單)

MES ERP 怎麼串接

表上最右邊那欄是同一系列的延伸文章。每一種情境都有自己的眉角,例如金流最怕「付款成功了但你的系統沒收到通知」,客人付了錢訂單卻顯示未付款;電子發票則是格式版本會跟著財政部規範走,後面講坑的時候會再提。

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 優先」,代表你接的對象會越來越常改版、越來越常加新功能。我們的取捨是:寧可少接一條,也要每一條都有監控和重送機制。給讀者的判斷方式很簡單:拿出你目前最常人工搬資料的那一段流程,算算每個月花幾小時、出錯過幾次,數字夠大再接,先從那一條開始。

ℹ️我們做過這件事

恆遠目前累積 40+ 企業客製案落地,串接是幾乎每個案子都會碰到的一段。我們自家的產品也是靠 API 串在一起:恆遠會員中樞系統把註冊、登入、訂閱與權限抽成共用中樞,各產品透過同一支授權查詢 API 確認使用者權限,新產品上線就接這一支。如果你也在想「我們公司那幾套系統要怎麼接才不會一直出包」,我們很樂意 聽你聊聊實際情況,一起看看從哪一條開始最划算。

QAPI 串接是什麼?

API 串接是讓兩套系統透過事先定義好的格式自動交換資料,例如電商訂單自動進 ERP、付款成功自動更新訂單狀態、發票自動上傳財政部平台,用來取代人工複製貼上與匯出匯入。

QAPI 串接要多久?

看對方 API 的品質與同步方向。對方文件完整、有測試環境、單向同步的串接,開發時間相對短;要雙向同步、自動對帳、或對方沒有測試環境,時間會明顯拉長。發包前先問清楚對方系統的 7 件事,估出來的工期會準很多。

QAPI 串接費用怎麼算?

主要看五個變數:對方 API 品質、單向或雙向、資料量與即時性、錯誤處理要求、監控與稽核要求。欄位數量影響反而不大。計費模式與合約紅線可以參考我們的 SaaS 接口整合費用拆解一文。

Q對方系統沒有 API 還能串接嗎?

有機會,但做法會變成檔案交換(定時匯出匯入 CSV)、直接讀資料庫,或請原廠另外開放 API。這幾種做法都比正式 API 脆弱,對方系統一更新就可能失效,簽約前要把維護方式講清楚。

QAPI 金鑰要怎麼保管?

金鑰不要寫進程式碼,放在環境變數或密鑰管理工具;每個系統用自己的金鑰並限制權限;金鑰開在公司帳號底下,人員異動時更換。外包合作結束時,也要把金鑰換掉。

Q用 n8n 做 API 串接可以嗎?

單向、量小、出錯可以晚點處理的串接,用 n8n 很划算。跟錢或庫存有關、要雙向同步、要稽核紀錄的串接,建議找人寫程式,或至少由專人維護 n8n 流程並加上監控。

分享文章
恆

AUTHOR

恆遠數位編輯團隊

查看作者頁

留言(0)

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

需要網站系統架設或軟體開發?

無論是品牌官網、客製化系統還是應用程式,我們的團隊擁有豐富經驗,歡迎聯繫我們,讓專業為您的事業加分。