開發者指南
將 Barcodesoft 集成至 Workday Extend
利用 Workday 協排（Orchestrations）和自定義 UI 組件，直接在您的 Workday 應用中生成動態條碼。
前提條件
完成訂單後，您將收到一封包含您的 User_id、Secret 和 Scope 的自動郵件。這些憑證是調用 https://www.barcodesoft.com/api/auth/token 端點進行身份驗證所必需的。
集成架構
1. 業務協排
Workday 協排負責管理 OAuth 2.0 權杖握手以及隨後對條碼服務的 REST 調用。
2. 安全存儲
權杖會緩存在應用會話中，以優化效能並遵守 API 頻率限制。
3. UI 組件
生成的 SVG 或 PNG 條碼將綁定到 Workday 應用介面中的圖像組件（Image Component）。
分步實施方案
1 獲取 Bearer 權杖
在 Workday Extend 中配置 外部服務（External Service），並使用以下參數獲取權杖：
POST https://www.barcodesoft.com/api/auth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id=[您的 USER_ID]
&client_secret=[您的 SECRET]
&scope=[您的 SCOPE]2 動態條碼端點調用
在您的協排中動態構建 URL。例如，生成一個 GS1-128 線性條碼：
| 參數 | 取值 | 用途 |
|---|---|---|
data | (02)12345... | 要編碼的負載數據 |
width | 3in | 實體寬度 |
imageformat | svg | 向量格式（推薦） |
dpi | 300 | 列印解析度 |
3 UI 展現 (PMD)
將協排返回的圖像 URL 映射到 Workday Extend 頁面代碼中的圖像組件：
{
"type": "image",
"label": "資產標籤條碼",
"sourceUrl": "${orchestrationResponse.barcodeUrl}"
}獲取您的集成憑據
訂購訂閱服務以解鎖雲端條碼 API 的完整訪問權限。 憑據（User_id, Secret, Scope）將立即通過電子郵件發送。
支援 GS1-128 & 二維碼
PNG, SVG, WebP 格式
OAuth 2.0 安全保障
優化建議
- 使用 SVG 進行縮放： SVG 在 Workday Extend 中原生支持，能為行動裝置掃描提供最佳體驗。
- 權杖過期處理： 在協排中實現 "Try-Catch" 模塊。如果條碼調用返回 401 錯誤，請重新整理權杖。
- URL 編碼： 對所有參數（尤其是
data欄位）進行編碼，確保像()這樣的特殊字元不會導致 REST 調用失敗。