在使用任何 SCC API 之前,每位合作夥伴都必須在 SupplyOn API 開發者入口網站進行註冊,並取得訂閱金鑰。本章概述了註冊步驟;第 2 章則說明在此基礎上所需的額外 OAuth2 客戶端憑證設定。
步驟 1 — 在開發者入口網站註冊
- 非生產環境( 測試 ): https://developer.api.non-prd.supplyon.com/
- 生產環境 : https://developer.api.supplyon.com/
請使用專用/共用且安全的電子郵件地址(例如團隊或服務信箱),而非個人信箱——此規定統一適用於兩種環境,以避免對單一人員的依賴。
步驟 2 — API 存取權限指派
作為您加入 SupplyOn 流程的一部分,系統將為您指派所需的 SCC API 存取權限(視情況而定,包含傳送和/或擷取資料)。若您尚未收到此指派,或對您的加入進度有任何疑問,請聯絡apirequest@supplyon.com或您的 SupplyOn 整合聯絡人。
步驟 3 — 建立訂閱並取得訂閱金鑰
- 請針對每個所需的 API 產品建立一個訂閱 — 傳送資料與擷取資料需分別建立獨立的訂閱。
- 訂閱狀態轉為「有效」後,請前往「個人資料」→「使用者個人資料」→「訂閱」中查找您的金鑰:包含一個「主要金鑰」和一個「次要金鑰」(兩者皆可使用;兩者均可存取同一訂閱)。
在每次 API 呼叫中,請將該金鑰用作以下 HTTP 請求標頭:
Ocp-Apim-Subscription-Key: 您的訂閱金鑰>
完成註冊並取得訂閱金鑰後,請繼續參閱第 2 章,進行 SCC API 所需的 OAuth2 客戶端憑證設定。