串接管理
目錄
一、使用情境
快速連結：讓官網或 ERP 自動送單 ｜ 收回外部廠商的存取權 ｜ 上檔前確認用量餘裕
情境 1：讓官網或 ERP 自動送單，不再靠人工匯入
狀況：您的官網一天進來幾百張訂單，目前靠匯出 Excel 再上傳給倉庫。單量一大就延遲，客服被問「我的訂單出貨了嗎」也只能回去翻檔案。
用這個功能：在這裡替您的官網或 ERP 建立一組串接憑證，把憑證交給負責開發的工程師或系統商，他們的系統就能直接把訂單送進來、即時查詢庫存與出貨狀態。憑證怎麼建立見新增串接。
結果：訂單自動落進倉庫作業，庫存與出貨進度以系統為單一真相，不必再維護中間那份 Excel。
情境 2：換了系統商或懷疑憑證外流，要立刻收回存取權
狀況：原本合作的系統商換人了，或您發現憑證可能被外流到不該持有的人手上。這組憑證能讀到您的訂單與庫存，不能等。
用這個功能：在清單上把那筆串接直接停用，或進入詳情頁重新產生 access token。兩種做法的差別與副作用見常見問題。
結果：舊憑證立即失效，對方的系統再也呼叫不進來；該串接的 Webhook 也會一併停止推送，不會繼續把您的資料送到對方的網址。
情境 3：大檔活動前，先確認串接的用量還夠不夠
狀況：雙十一要開檔，您的系統商說他們會在開賣前把所有商品資料重新同步一次。您想知道這樣會不會把當天的用量用完，導致真正的訂單反而送不進來。
用這個功能：清單頁上方的 Partners API 每日用量 卡片，看今天已經用掉多少、過去三個月每天的用量節奏。
結果：知道平常的用量水位與尖峰落在哪幾天，據此決定要不要請系統商改期、分批同步，或事先聯繫我們調整額度。
二、功能介紹
串接管理是您把 GoWarehouse 接上自家系統的入口。您在這裡替每一個要連進來的系統（官網、ERP、客服工具）各建立一組憑證，對方用這組憑證呼叫我們的 API 送訂單、查庫存、接出貨通知。一組憑證對應一個系統，日後要收回存取權時可以只停掉那一組，不影響其他串接。
2.1 Partners API 每日用量
頁面最上方的卡片顯示這個貨主的 API 用量。額度是整個貨主共用的：不論您建立了幾組串接憑證、對方用的是哪一個 API 版本，全部算在同一份額度裡。
| 區塊 | 說明 |
|---|---|
| 今日已用 | 今天累積的呼叫次數與當日上限。進度條在未達 80% 顯示綠色、80% 起轉黃、達上限轉紅 |
| 剩餘 | 今天還可以呼叫幾次 |
| 重設時間 | 下一次歸零的時間點，以您組織設定的時區換日 |
| 過去三個月 | 每一格是一天，顏色越深代表當天用量越高；滑過格子會顯示該日的實際次數與佔上限的百分比 |
預設額度是每天 10,000 次。認證失敗、IP 不被允許、API 版本不符的請求不計入；通過認證後的請求一律計入，包含權限不足或資料有誤而失敗的那些。
用量達到上限後，後續請求會收到 429 並附上可重試的時間，直到當地午夜重設。需要長期或臨時調高額度請聯繫我們。
💡 提示：用量統計是公平使用的概略保護，不是精確計費帳本。計數服務短暫無法讀取時，卡片會顯示「無法取得」而不是 0——此期間額度不會阻擋請求。
2.2 串接清單
| 欄位 | 說明 |
|---|---|
| 名稱 | 您替這組串接取的名稱，點擊進入詳情頁 |
| Client ID | 這組串接的識別碼，交給對方工程師辨識用；可點擊複製 |
| 串接類型 | 建立時的相容識別；正式日期版升級不須重建憑證 |
| 權限範圍 | 這組憑證被允許做的事；最多顯示 3 項，其餘以數字摺疊 |
| Webhook | 是否設定了事件推送網址，圓點顯示推送目前是啟用或停用 |
| 啟用狀態 | 直接切換啟用／停用，不必進入詳情頁 |
| 最後使用時間 | 對方最後一次成功呼叫的時間，可用來判斷這組憑證是否還在使用 |
舊版 API 版本（legacy）沒有權限範圍的概念，該欄位會顯示「—」。
2.3 新增與管理
| 操作 | 前置條件與副作用 |
|---|---|
| 建立 | 進入新增串接。建立完成會產生一組 client ID 與 access token |
| 啟用／停用 | 停用後，對方的所有呼叫會被擋在認證階段。停用會同時把這組串接的 Webhook 一起停掉；重新啟用時 Webhook 不會自動恢復，需到串接詳情開啟 |
| 查看 | 進入串接詳情查看憑證、權限範圍與 Webhook 設定 |
| 刪除 | 永久刪除這組憑證，不可復原。刪除前會先停用其 Webhook，避免推送繼續送往對方的網址 |
三、常見問題
3.1 FAQ
▪ 停用和刪除有什麼差別？該用哪一個？
停用是可逆的：憑證還在，對方打不進來，之後可以再開回去。適合暫時中止合作、或排查問題時先切斷。
刪除是永久的：憑證連同記錄一起消失，無法復原，對方就算保留著 token 也失效。適合確定不再合作的對象。
兩者都會停掉該串接的 Webhook。差別在於停用之後重新啟用時，Webhook 不會自動跟著恢復，需要到串接詳情用那裡的開關手動開回來——這是刻意的設計，避免中止期間的資料在恢復瞬間誤送出去。
▪ 憑證可能外流，但我還要繼續讓對方串接，怎麼辦？
進入詳情頁重新產生 access token。新 token 一產生，舊 token 立即失效，中間沒有並存的緩衝期，所以請先跟對方約好切換時間，再按下去。client ID 不會改變。
▪ 為什麼 API 版本建立後不能改？
建立時選擇的是正式或舊版串接類型，這項分類無法變更。正式串接可用同一組憑證呼叫 v1 與已發布日期版本（目前預設為 2026-09，2026-10 保留相容）；請對方工程師測試後切換呼叫的版本，不必重建憑證。跨正式／舊版類型才需要另建串接。
▪ 用量卡顯示的數字，和我自己系統記錄的呼叫次數對不起來？
有幾個正常的原因：被每秒／每分鐘的節流擋下的請求不計入日額度；認證、IP、版本檢查沒過的請求也不計入。另外，用量統計本身是概略保護，計數服務重啟時可能少計。它適合看趨勢與公平使用，不適合當對帳依據。
▪ 我有好幾個系統要串，要建幾組憑證？
一個系統建一組。這樣日後要收回某一方的存取權時，可以只停掉那一組，不會波及其他串接；用量出問題時也能從 client ID 看出是誰打的。要注意的是每日額度是整個貨主共用，建立多組憑證並不會增加總額度。
▪ 我沒看到「串接管理」這個選單？
需要 integrations:read 權限才看得到。請您的帳號管理者到用戶管理確認權限設定。
3.2 注意事項
⚠️ 重要提醒
- 刪除串接不可復原，且會連同其 Webhook 設定一併解除。確定不再合作再刪，否則請先停用。
- 重新產生 access token 會讓舊 token 立刻失效，對方的系統會在下一次呼叫時開始失敗。務必先約好切換時間。
- 停用後重新啟用，Webhook 不會自動恢復，需到串接詳情手動開啟；否則對方會以為串接恢復了卻收不到事件推送。
- 正式／舊版串接類型不可互換；日期版升級方式見API 版本。
💡 提示：最後使用時間 是清掉無用憑證的好依據——長期沒有呼叫記錄的串接多半是舊合作留下的，留著只是多一個外流風險。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 新增串接 | 建立一組新的 API 憑證並設定權限範圍 | 前往 |
| 串接詳情 | 查看憑證、權限範圍與 Webhook 設定 | 前往 |
| 編輯串接 | 調整名稱、權限範圍、IP 限制與 Webhook | 前往 |
| 用戶管理 | 調整誰可以查看與管理串接 | 前往 |