Barcodesoft API 與 SAP SuccessFactors 整合
實現動態條碼生成的詳細技術步驟。
1
OAuth 2.0 身分驗證流程
訂單處理完成後,您將收到一封包含 User_id、Secret 和 Scope 的電子郵件。這些資訊是獲取 Bearer Token(持有者權杖)所必需的[cite: 3, 4]。
權杖請求端點:
POST https://www.barcodesoft.com/api/auth/token
所需的本文參數 (application/x-www-form-urlencoded):
| 鍵 (Key) | 值 / 來源 |
|---|---|
grant_type | client_credentials |
client_id | 您收到的 User_id[cite: 3, 4] |
client_secret | 您收到的 Secret[cite: 3, 4] |
scope | 您收到的 Scope[cite: 3, 4] |
2
SAP SuccessFactors 配置
安全中心 (Security Center)
建立一個新的 OAuth 配置。使用第 1 步中的詳細資訊。根據您的 SF 版本要求,確保「用戶端驗證」設定為「作為 Basic Auth 標頭傳送」或「在本文中傳送」[cite: 3, 4]。
整合中心 (Integration Center)
定義您的 目的地設定 (Destination Settings)。如果身分驗證綁定正確,系統在呼叫下方的 REST 端點時將自動使用該權杖[cite: 3, 4]。
3
條碼生成端點
一維條碼 (GS1-128)
常用於運輸標籤和物流。支援應用程式識別碼 (AI)[cite: 3, 4]。
https://www.barcodesoft.com/barcode/v1/linear/gs1128?data=(02)12345(10)ABCD&width=3in&height=1in&imageformat=png
方向 (Orientation): original, rotate90, rotate180[cite: 3, 4]
解析度 (DPI): 96, 300, 600[cite: 3, 4]
格式: PNG, JPG, WebP, SVG[cite: 3, 4]
二維條碼 (二維碼/QR Code)
適用於員工名片或透過行動裝置掃描識別證[cite: 3, 4]。
https://www.barcodesoft.com/barcode/v1/qrcode/?data=EmployeeID123&size=2in&imageformat=svg&dpi=300
實施最佳實務
- SVG 優勢: 在 SuccessFactors 文件生成中,建議始終優先選擇
imageformat=svg,以確保條碼在調整大小或列印為 PDF 時保持清晰[cite: 3, 4]。 - 資料編碼: 為
data參數使用 URL 編碼,特別是當您的字串包含空格、連接符 (&) 或括號時[cite: 3, 4]。 - 快取處理: 考慮到這些是 REST 呼叫,請評估在高吞吐量文件生成時的效能影響。Barcodesoft 雲端架構已針對高並發進行了優化[cite: 3, 4]。