點擊每頁的左下角 圖標可全屏播放。

「相信」整合開發流程

為您的系統打造一個標準、安全、高效的整合體驗

版本/日期:v2.2 / 2026-05-16
製作單位:中央授權中心 開發維運團隊


整合流程概覽

相較舊版(2022年前),新流程將「業務身份」與「應用程式身份」的申請與授權分離,職責更清晰。

申請頻道帳號 (行政人員)
申請 ClientID (開發人員)
申請 API Scope (開發人員)
ClientID 綁定頻道 (行政人員、開發人員)
使用平臺及應用中心 (行政人員)
聯系業務推廣 (行政人員)
系統開發與發佈 (開發人員)

階段一:身份申請 (業務 vs. 應用)

1. 申請頻道帳號


  • 負責人員:行政窗口
  • 目的:為您的「業務單位」取得相信單位賬號,用於後續的內容發佈與使用者互動。
  • 分類:根據服務人員範圍類型可分訂閱臺、服務臺、廣播臺。
  • 產出物:一組頻道帳號。

2. 申請 OIDC ClientID


  • 負責人員:開發人員
  • 目的:為您的「應用程式」接中央授權中心註冊一個合法的技術身份,以實現相信單點登錄、接口權限管控。
  • 產出物:一組 Client ID / Secret。
  • 參考文件:快速接入單點登入

階段二:客戶端授權

3. 申請 API Scope


  • 負責人員:開發人員
  • 目的:為您的ClientID申請具體操作 API 的權限,應遵循最小權限原則。
  • 範例:為 ClientID 申請 `civet.api.msg` 權限,使其只能發送消息,不能操作其他 API。
  • 參考文件:API資源交易配置說明

操作步驟說明

  • 開發負責人前往「中央授權中心 - 開發中心」,選擇對應的客戶端,點擊「修改」進入「API資源」>>「API客戶端間授權(API交易)」介面,獲取 請求TOKEN申請原因(模板)
  • 向 API 提供方提出 API Scope 申請時,需一併提供 客戶端ID請求TOKEN申請原因
  • 若申請「相信」相關的 API Scope,可直接透過「相信」將上述資訊發送給以下管理員進行辦理。
  • 26520(王泰元)F3218466(劉曉飛)F3232041(邱喜威)

階段三:關聯頻道賬號

4. ClientID 與頻道帳號綁定


  • 負責人員:由開發/行政人員發起申請,平台管理員執行操作。
  • 目的:將「應用程式身份」與「業務單位身份」進行關聯,正式授權該程式代表此單位執行操作。
  • 核心:完成此步驟後,您的程式才能用 ClientID 獲取代表頻道帳號的 Access Token。

操作步驟說明

  • 開發負責人前往「中央授權中心 - 開發中心」,選擇對應的客戶端,點擊「修改」並進入「賬號關聯」設定介面。
  • 點選「新增(頻道)賬號關聯」並輸入頻道賬號,生成綁定申請連結(系統會同步產出包含申請說明的郵件模板)。
  • 開發負責人將該連結發送給頻道的管理人員(通常為行政人員)。
  • 頻道管理人員點擊連結並同意授權,即可完成頻道賬號與客戶端的綁定手續。

階段四:開發系統、發佈

完成以上所有配置後,開發人員即可得到如下核心開發任務:

  • 實現相信單點登錄:遵循 OIDC/OAuth 2.0 標準流程完成對接。
  • 呼叫開放接口:使用獲取的 Access Token 調用「相信開放接口」執行業務操作。
  • 實現消息推送:可使用接口向員工推送消息/網站鏈接、接收消息、AI智能回覆、設置功能菜單;跟業務人員聯系設置系統入口圖標。
  • 整合原生功能:在您的 Web 系統中,透過 Js SDK 調用相信 App 的原生能力。
  • 導入 RWD 響應式網頁設計:接入系統需全面支援響應式排版,兼容桌機、平板、手機及相信 App 內嵌頁面瀏覽,確保不同裝置瀏覽體驗一致、介面正常顯示與操作。

總結



流程總結:為何要這樣設計?

相較於過去的單一步驟,新的整合流程雖然更精細,但它帶來了三大好處:
1. 職責分離:行政管「業務身份」,開發管「應用身份」,權責分明。
2. 權限最小化:應用程式需明確申請 API Scope,無法再獲取超出其職責的權限。
3. 安全性與可追溯性:每一次 API 呼叫都能精確追溯到是哪個「應用程式」代表哪個「業務單位」進行的操作,大幅提升系統安全性。


相信全球化資料訪問權限

支持登錄用戶 / 訪問令牌範圍
類型
賬號格式
Headquarters (總部版)
工號
Indian (印度版)
工號@in-foxconn
Mexico (墨西哥版)
工號@mx-foxconn
US (美國版)
工號@us-foxconn
ITE (內測版)
工號@hh.com
Internal01 (產線版01)
工號@plieve
Internal02 (產線版02)
工號@a-plieve

開通說明

  • 客戶端預設僅開通 總部版 (Headquarters) 的權限。
  • 開發負責人可前往「中央授權中心 - 開發中心」,選擇對應客戶端並點擊「修改」,進入「客戶端詳情」介面以確認目前具備的權限範圍。
  • 如需開通其他區域的版本權限,請透過「相信」直接聯繫以下管理員進行辦理:
  • 26520(王泰元)F3218466(劉曉飛)F3232041(邱喜威)