串接詳情
目錄
一、功能介紹
查看一組串接的完整設定：它被授權做什麼、憑證是什麼、最後一次被呼叫是什麼時候，以及 Webhook 推送的狀況。排查「對方說串不進來」或「要收回權限」時，都從這一頁開始。
1.1 基本資料
| 欄位 | 說明 |
|---|---|
| 名稱 | 這組串接的名稱 |
| 串接類型 | 建立時的相容識別；正式日期版升級不須重建憑證 |
| 啟用狀態 | 目前是否可用。停用中的憑證，對方的呼叫會被擋在認證階段 |
| 描述 | 建立時填的用途說明 |
| 建立時間 | 建立時間 |
| 最後使用時間 | 最後一次成功呼叫的時間。長期空白代表對方根本沒接上，或早就不用了 |
1.2 憑證
| 項目 | 說明 |
|---|---|
| Client ID | 這組串接的識別碼，可公開給對方工程師 |
| Access Token | 呼叫 API 用的密鑰，等同密碼。可複製交付給對方 |
這裡也提供重新產生 access token。按下後新 token 立即生效、舊 token 同時失效，中間沒有並存期間；client ID 不會改變。對方系統會在下一次呼叫時開始失敗，直到換上新 token，所以請先約好切換時間。
⚠️ 能開啟這一頁的人就看得到 access token。請確認只有該有權限的同事能存取用戶管理中的串接權限。
1.3 權限範圍
這組憑證被允許做的事。要增減請到編輯串接。
舊版（legacy）API 版本沒有權限範圍的概念，這個區塊不會出現——該憑證可存取舊版開放的全部功能。
1.4 Webhook
如果這組串接設定了事件推送，這裡顯示：
| 項目 | 說明 |
|---|---|
| URL | 事件要送到對方的哪個端點 |
| Webhook 版本 | 推送內容的格式版本，與這組串接的 API 版本各自獨立 |
| 訂閱事件 | 目前會推送哪些事件 |
| 簽章驗證 | 對方用來驗證推送確實來自我們。這裡顯示的是遮罩後的金鑰（只露頭尾）。旁邊有「重新產生密鑰」按鈕，但在這一頁按下去不會顯示新金鑰——見下方提醒 |
| 發送次數 | 這個 Webhook 至今累積的推送筆數 |
啟用狀態的開關在這個區塊的標題列右側（只有勾／叉圖示，沒有文字），可以直接在這一頁切換，不需要進編輯頁。關掉後停止推送、設定本身保留，隨時可以開回來；這期間發生的事件不會在重新開啟時補送。
⚠️ 不要在這一頁按「重新產生密鑰」。 按下去會立刻換發新金鑰、舊金鑰同時失效，但這一頁不會顯示新金鑰（只會再顯示一次遮罩值）。結果是對方驗簽開始失敗、而您拿不到新金鑰交付。要換金鑰請到「Webhook 設定」頁面操作，那裡在產生當下會顯示完整金鑰供複製。
要調整網址、版本或訂閱事件，請到編輯串接。
測試：按下後會真的送出一次推送到上面那個網址——對方系統會實際收到一筆測試事件，不是模擬。送出後跳出的視窗顯示這次的狀態、回應碼與耗時，可用來確認對方端點通不通、簽章設定對不對。從回應碼可初步判斷是對方伺服器回了錯誤（5xx）還是網址或簽章設定錯誤（4xx）；連不上或逾時則沒有回應碼，會顯示為 N/A。
要注意的副作用：這次測試會被記成一筆正式的推送紀錄，發送次數會加一，在「Webhook 紀錄」裡也查得到（標記為手動觸發，與系統自動推送分開）。測試失敗不會自動重試。
停用整組串接時，Webhook 會一併停用；重新啟用串接時 Webhook 不會自動恢復，需要用上面那個開關手動開回來。
1.5 刪除
刪除這組憑證。不可復原，對方保留的 token 立即失效，其 Webhook 也會先被停用再解除關聯。只是暫時中止合作的話，請改用停用。
二、常見問題
2.1 FAQ
▪ 對方說一直收到 401／認證失敗，我該看哪裡？
依序確認三件事：這一頁的啟用狀態是不是被停用了；對方用的 token 是不是最新的（如果曾經重新產生過，舊的就失效了）；以及編輯頁的 IP 限制有沒有把對方的來源擋掉。
▪ 對方說收到 403／權限不足？
那不是憑證問題，是權限範圍沒給到他要做的事。到編輯頁把對應的項目勾上即可，不需要重新產生 token。
▪ 對方說收到 429？
代表撞到用量限制。可能是短時間呼叫太密集，也可能是當日總額度用完了。到串接管理看每日用量卡確認是哪一種。
▪ 最後使用時間一直是空的，代表串接失敗嗎？
代表從來沒有一次成功的呼叫。可能是對方還沒開始接，也可能是憑證、IP 或版本設定有落差。先請對方提供他們收到的錯誤訊息，再對照上面幾題判斷。
▪ Webhook 一直推送失敗，會影響訂單本身嗎？
不會。Webhook 是額外的通知管道，推送失敗不影響訂單或庫存資料本身，對方仍可以主動呼叫 API 查詢。但請盡快處理，否則對方的系統會一直拿到過期的狀態。
▪ 商品刪除後，對方還能查到原本的庫存嗎？
正式版本（v1、2026-09、2026-10）的庫存列表預設排除已刪除商品。歷史對帳時，請對方工程師明確選擇包含已刪除商品；既有庫存詳情仍可查閱，刪除不會清空實體庫存。未刪除商品的耗盡與鎖定批次則仍可查到，可用篩選只查看正常批次。
若對方需要同步商品刪除，須同時具備商品讀取權限，並從包含已刪除商品的商品清單取得刪除時間；只接收庫存異動通知不會得知商品刪除。同一 SKU 可被新商品重用，請對方以商品識別碼區分，避免把新舊商品的庫存加在一起。參數與欄位請依對應版本的串接文件設定。
2.2 注意事項
⚠️ 重要提醒
- 重新產生 access token 沒有並存緩衝期，舊 token 在新 token 產生的同一刻失效。
- 刪除不可復原，且會一併解除 Webhook 設定。暫時中止請用停用。
- 這一頁看得到完整的 access token，請控管誰有權限開啟。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 串接管理 | 查看所有串接與每日用量 | 前往 |
| 編輯串接 | 調整權限範圍、IP 限制與 Webhook | 前往 |
| 新增串接 | 建立另一組憑證 | 前往 |