sales-squarespace

用途：面向 Squarespace 的电商层自动化与集成，不涉及站点构建器（页面与主题仅能在界面操作，无站点构建 API）。主要能力：通过 Commerce API（Orders、Inventory、Products、Transactions、Contacts）读写数据，并用 OAuth 注册网络钩子实现实时事件。使用方式：自有站点可用 API Key（Bearer）读写，网络钩子必须用 OAuth；写入需 Content-Type: application/json，并自定义 User-Agent；基础地址为 https://api.squarespace.com/{version}/{path}，仅 HTTPS，版本按端点区分（如 Orders 1.0、Products 2）。实时自动化优先用 order.create/order.update 钩子，但其载荷仅含 orderId，需再 GET 完整订单并按 order.id 去重；无法托管监听器时改用 modifiedAfter 与 modifiedBefore 配对轮询。限制与注意：Commerce API 受套餐限制，免费试用或个人/Basic 套餐无 API；网络钩子仅 OAuth 可注册；HMAC 密钥为十六进制，需先解码为字节再对原始请求体做 HMAC-SHA256 校验；金额为 {currency, value} 小数对象而非整数分；捐赠需走 Transactions API；不支持多币种，网关有限，且非记录商户（税由自己承担）。资料中部分套餐与定价信息标注为尽力核实，可能过时，需以官方文档为准。