用途:面向中端市场与 B2B 商家的开源电商平台 Shopware 6(shopware.com)的平台使用指导,覆盖商品、订单、客户等后台数据的读写、无头店面搭建、事件响应、目录批量同步、店铺配置与版本选型。
主要能力:平台提供两类 HTTP API——Admin API(/api/,后台)与 Store API(/store-api/,无头店面),并有支持 webhook 的 App 系统与 Flow Builder 自动化。支持通过 Admin API 读写后台实体,通过 Store API 实现购物车与结账,通过 App webhook 或 Flow Builder 响应事件(如下单、商品变更),通过 Sync API 批量导入/同步目录,以及配置销售渠道、商品与插件。
使用方式:Admin API 需在 Settings → System → Integrations 手动创建 Integration 获取凭据,使用 POST /api/oauth/token、grant_type=client_credentials 获取令牌;Store API 使用 sw-access-key 而非 OAuth。查询采用 POST /api/search/{entity} 加 Criteria JSON 体(filter、sort、limit、page、associations、aggregations),分页用 limit+page。批量写入用 POST /api/_action/sync。事件通过 App 系统 manifest 的 webhooks 注册,投递头 shopware-shop-signature 为请求体的 HMAC-SHA256。
适用场景:集成开发、自动化同步、无头店面、B2B 与自托管商店。
限制:Admin API 限制 300 请求/分钟,超限返回 429。自托管需运行 PHP 8.2+/Symfony、MySQL/MariaDB、OpenSearch 与消息队列,需要开发与托管及 PCI 预算。ID 为 32 位十六进制 UUID,字段可按语言上下文翻译,不能假设整数 ID 或单一语言环境。版本间字段与后台技术栈有差异;Shopware 不是 Merchant of Record,VAT/税务由商家自行承担。资料未提供具体安装命令与价格细节。