2025 年 9 月

SCAPI 和 SLAS

有关更详细的发布信息，请参阅 B2C Commerce API 版本说明。

SCAPI：

使用 B2C Commerce 25.10：

• CORS 配置 API 现在支持配置除 HTTP 和 HTTPS 之外的其他协议的允许来源。
• 购物者客户 v1.1.1
• • 新增可选参数，用于在创建客户时设置默认客户支付工具。
  • 现在，使用 get /customer 和 get/customer/payment-instrument/{id} 端点检索支付工具时，会返回默认标记。
• 新增只读的自定义 API 状态报告，提供以下信息：
  • 自定义 API 的注册状态。当您激活包含自定义 API 的代码版本时，此端点会生成报告，其中包含每个端点注册结果的详细信息，包括状态、配置详情以及注册失败时的错误诊断。
  • 实时端点监测：立即获取自定义 API 端点是否成功注册为 ACTIVE 状态或注册失败为 NOT_REGISTERED 状态的反馈，无需手动搜索日志进行故障排除。
  • 完整的端点详情：每个端点响应都包含完整的元数据 (metadata)，例如 API 名称和版本、插件名称、HTTP 方法、实施脚本、OpenAPI 模式文件、站点 ID、安全方案以及注册失败的详细错误信息。
  • 灵活的筛选功能：您可以查询所有端点，或按注册状态筛选，以专注于存在问题的端点。此外，它还支持在 B2C Commerce 实例中对所有站点和插件进行组织级可见性管理。
• 新增购物者配置 API
  • 这是只读 API，返回商家配置的实例和站点特定属性详细信息，包括但不限于站点 ID、名称、状态、区域设置、货币、时区以及某些已启用的功能，例如 Salesforce Payments。
  • 每个配置值都包含一个配置类型，详细说明它是全局配置还是站点特定配置。
  • 随着 B2C Commerce 的发展，我们将向此 API 添加更多实例和站点特定的配置详细信息。
• 引入了新的 dw.order.mergeBasket 挂钩，以标准化和简化购物车合并的自定义。您可以使用 transferBasket 端点和新的 merge=true 参数来调用此挂钩。这确保了所有相关功能均可一致使用相同合并脚本，从而统一之前控制器和 REST API 合并策略之间的差异。我们推荐使用此合并方法，因为其他合并方法现已弃用。
• 对于购物者搜索 API productSearch 端点，更新了 select 参数文档，并包含示例。
• 在相应的 API 摘要页面上，为每个 SCAPI OAS 规范添加了下载链接。
• 添加了粒度复制 API 端点，用于发布产品、价格表和内容素材。发布项目功能目前仅支持从 STG 到 PRD，无法在沙盒 (Sandbox) 环境中进行测试。此功能将在 25.10 版在 PIG 实例上推出后可用。
• 借助 自定义 API 端点，您现在可以通过用户友好且安全的方式在实例上列出您的自定义 API，并获取端点注册状态的实时反馈，包括注册成功和带有错误代码的失败尝试。
• 购物者配置 API 是一个只读 API，它返回商家如何配置实例和站点特定属性的详细信息，包括但不限于站点 ID、名称、状态、区域设置、货币、时区以及某些已启用的功能，例如 Salesforce Payments。每个配置值都包含一个配置类型，详细说明它是全局配置还是站点特定配置。随着 Commerce Cloud 的发展，此 API 将添加更多实例和站点特定配置的详细信息。

SLAS：

• 现在，您可以同时维护两个活动密钥（主密钥和辅助密钥），并且可以轮换使用它们而不会中断服务。请参阅客户端密钥管理和轮换。
• 为了增强安全性并符合 OAuth 2.1 规范，现在禁止在公共客户端重复使用相同的 refresh_token。refresh_token 实现一次性使用，即在每次 /token 调用时使用 SLAS 签发的新 refresh_token。有关详情，请参阅访问令牌和刷新令牌。