SuperAPI AI 工具集

occ-headless-frontend

前端与建站

查看项目

更新于 10-15 21:38

技能介绍

用途:在不使用 Spartacus 的前提下,为 SAP Commerce Cloud 的 OCC REST API(路径 /occ/v2)构建、评审与调试无头店面前端,支持 Angular、React/Next.js、Vue/Nuxt。后端(Java 控制器、WsDTO、ImpEx、扩展)与 Spartacus 定制不属于本技能范围。

主要能力:指导如何从各框架正确调用 OCC、令牌与购物车 ID 的存放位置,以及会打破常规 REST 假设的 SAP 特有行为。目标版本为 SAP Commerce Cloud 2211-jdk21 及 2025 年 9 月框架更新之后;JDK17 版本已无法构建,其 OAuth 行为不同。

使用方式:先定位站点上下文,调用 GET {host}/occ/v2/basesites?fields=FULL(无需令牌);再取接口契约 GET {host}/occ/v2/api-docs,并可用 npx openapi-typescript <spec-url> -o src/occ/occ.d.ts 生成类型。默认架构建议通过框架服务端做 BFF 调用 OCC,令牌放 httpOnly、Secure、SameSite=Lax Cookie,登录用授权码 + PKCE 与机密客户端。OCC 客户端需拼 {host}/occ/v2/{baseSiteId}/{path},始终带 lang、curr 与 Accept: application/json,统一处理 OCC 与 OAuth 两种错误格式,避免并发刷新令牌与并发写购物车。

适用场景:登录、购物车与结账、商品与搜索、CMS、账户、B2B 等前端任务,以及 CORS、401、400、图片缺失等排错。

限制:具体项目配置、后端 api-docs 与支付扩展需以实际后端为准;参考资料未提供的细节暂未提供。