开发者指南
将 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 调用失败。