用途:帮助开发者用 Salesforce B2C Commerce 的无头 API 构建自定义店面、移动端电商与第三方集成。资料区分两套接口:SCAPI(Shopper API)基于 SLAS 令牌,推荐用于无头店面、PWA Kit 与第三方集成;OCAPI 使用 Basic/OAuth,其中 Data API 仍用于服务端管理操作(商品导入、订单管理、促销管理)。
主要能力:SLAS 访客与客户令牌获取及刷新(PKCE、refresh_token);Shopper Products/Search API 的商品搜索与详情查询;Shopper Baskets API 的创建购物车、加购、设置收货地址;Shopper Orders API 提交订单;OCAPI Data API 的订单查询、状态更新与商品 upsert。基础 URL 形如 https://{shortCode}.api.commercecloud.salesforce.com/。
使用方式:配置 SFCC_SHORT_CODE、SFCC_ORG_ID、SFCC_SITE_ID、SLAS 客户端 ID 与重定向 URI 等环境变量;先取令牌,再以 Bearer 头调用各 API。管理端令牌通过 https://account.demandware.com/dwsso/oauth2/access_token 以 client_credentials 获取。
适用场景:无头 B2C 店面、PWA Kit 自定义调用、移动 App 商品与结账、服务端订单集成、OCAPI 迁移到 SCAPI。
限制与注意:SLAS 访问令牌约 30 分钟过期,需主动刷新;令牌应存于 httpOnly Cookie,OCAPI 凭据不可暴露;购物车合并要求同一 SLAS 客户端 ID;重定向 URI 需在 Business Manager 精确注册;注意 429 限流与搜索索引状态。资料未提供具体收费与价格信息。