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]。