SuperAPI AI 工具集

commerce-js-integration

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:Commerce.js(Chec)是托管式无头电商平台,其 JavaScript SDK 封装 REST API,用于管理商品、购物车、结账与订单。适合为静态站或 React/Vue/Svelte 项目快速加入电商能力,无需复杂后端;适用于作品集、MVP、概念验证,商品目录较小(约 1000 件以内)且无需自定义履约逻辑的场景。

主要能力:商品列表与按 permalink 检索、购物车生命周期(增删改、清空、刷新)、结账令牌生成与订单捕获、商品变体(如尺寸、颜色)选择、客户登录后查询订单。SDK 基于 Promise,购物车 ID 自动存于 localStorage。

使用方式:安装 npm install @chec/commerce.js,以默认导入方式初始化:import Commerce from '@chec/commerce.js'; const commerce = new Commerce(process.env.NEXT_PUBLIC_CHEC_PUBLIC_KEY, true); 公钥从 Chec Dashboard 的 Developer → API keys 获取。商品用 commerce.products.list() 与 retrieve();购物车用 commerce.cart.add/update/remove/empty/refresh;结账先 commerce.checkout.generateToken(cart.id, {type:'cart'}),再 getLive() 获取运费税费,最后 capture() 提交客户、配送、履约与支付信息(如 Stripe 的 payment_method_id)。

限制与注意:客户端用公钥(仅可读商品、管理购物车),服务端用密钥(可管理订单,不可暴露浏览器);客户端只初始化一次实例;结账令牌有效期 7 天,过期需重新生成;订单捕获后应调用 commerce.cart.refresh() 生成新空购物车;商品描述为 Chec CMS 的 HTML,渲染前须用 DOMPurify 等净化;支付网关需在 Dashboard 的 Setup → Payment gateways 中配置。资料未提供具体收费、价格与平台支持细节。