新StoreClaw 荣登 Product Hunt 当周产品第一名
StoreClaw

连接 Wix 后，StoreClaw 可以在授权范围内读取站点、订单、产品等相关数据，用于分析、简报和后续自动化任务。本文说明如何获取连接 Wix 所需的 3 项信息：API Key Token、Site ID 和 Account ID。

为什么需要连接 Wix

连接完成后，StoreClaw 可以基于 Wix 数据执行相关任务：

  • 店铺数据分析： 基于订单、产品和站点数据生成经营分析结果。
  • 站点级操作支持： 通过 Site ID 精确识别目标站点，避免多站点账号混淆。
  • 账号级接口调用： 通过 Account ID 配合 API Key 完成账号级授权访问。

连接前请确认

在开始操作前，请先确认当前 Wix 账号满足以下条件：

  • 您已登录目标 Wix 账号。
  • 当前账号角色为 Owner 或 Co-owner。
  • 如果账号只有 Collaborator 等普通权限，通常无法创建 API Key。

获取 Wix 连接信息

连接 StoreClaw 需要依次获取以下 3 项信息：

  1. API Key Token
  2. Site ID
  3. Account ID

整个流程通常约需 5 分钟。

第一步：创建 API Key 并复制 Token

Wix 提供的是账户级 API Key。同一个 Key 可以访问该账户下已授权的所有站点，因此建议仅授予当前任务所需权限。

1. 进入 API Keys 页面

  1. 登录您的 Wix 账户。
  2. 登录后，在页面左侧导航栏中选择 Account Settings -> API Keys。
  3. 进入 API Keys 页面后，点击右上角的 Generate API Key。

Wix Generate API Key

2. 填写 Key 名称并设置权限

  1. 打开浏览器，访问以下地址：https://manage.wix.com/account/api-keys
  2. 在 Key details 区域的 Name 字段中填写一个便于识别的名称。
  3. 推荐命名为 StoreClaw Connection，便于后续识别用途。
  4. 名称长度上限为 30 个字符，建议包含用途和平台名。
  5. 向下滚动到 Permissions 区域，根据需求勾选对应权限。

以下是常见权限项说明：

权限选项 说明 建议
All permissions 包含所有账户级和站点级数据访问权限 StoreClaw 连接推荐选择
Basic permissions API Key 的基础请求权限 默认包含，无需单独勾选
All account permissions 管理账户级数据，如高级服务、子账户等 视需求勾选
All site permissions 管理站点级数据，如店铺、预约、活动等 视需求勾选

提示： 推荐命名格式可使用 StoreClaw Connection。如果您的团队会同时创建多个 Key，也可以在名称中加入用途或环境标识，便于区分。

注意： 出于安全考虑，建议遵循最小权限原则，仅勾选实际需要的权限。一般情况下，StoreClaw 读取订单、产品、客户等数据通常需要 All site permissions；如需涉及跨站点或账号级管理，再考虑启用 All account permissions。

3. 生成并复制 Token

  1. 确认名称和权限无误后，点击右上角的 Generate Key。
  2. 系统会立即弹出提示框，显示完整 Token。
  3. 点击 Copy Token & Close，复制并保存该 Token。

Wix API Token Modal

注意： Token 只会完整显示一次。关闭弹窗后，Wix 不会再次展示完整 Token。如果忘记复制，只能删除旧 Key 后重新生成。

第二步：获取 Site ID

Site ID 用于标识 Wix 账号下的具体站点。StoreClaw 读取订单、产品等站点级数据时，需要通过 Site ID 锁定目标站点。

1. 从 Dashboard 地址中提取 Site ID

  1. 登录 Wix 并进入目标站点的管理后台（Dashboard）。
  2. 查看浏览器地址栏，URL 通常类似如下格式：
https://manage.wix.com/dashboard/{Site ID}/home
  1. 其中 /dashboard/ 与 /home 之间的那段 UUID 字符串，就是 Site ID。

Wix Site ID From Dashboard URL

2. 复制 Site ID

  1. 点击浏览器地址栏，全选当前 URL。
  2. 找到 /dashboard/ 与 /home 之间的 UUID 部分并单独复制。
  3. 如果一个账号下有多个站点，请进入对应站点后台，分别提取各自的 Site ID。

第三步：获取 Account ID

Account ID 是 Wix 账户的唯一标识符，属于账号级 ID。它与 Site ID 不同，一个账号通常只有一个 Account ID。

1. 在 API Keys 页面查看 Account ID

  1. 返回 API Keys 页面。
  2. 在页面右侧找到 Account ID 面板。
  3. 点击右侧的 Copy ID 按钮即可复制。

Wix Account ID Copy

在 StoreClaw 中完成配置

获取以上 3 项信息后，返回 StoreClaw 完成配置：

  1. 在 StoreClaw 左侧导航栏点击 连接器。
  2. 找到 Wix 卡片并点击。
  3. 填写以下字段：
    • API Key： 粘贴刚才复制的 Token。
    • Site ID： 粘贴从 Wix Dashboard URL 中提取的站点 ID。
    • Account ID： 粘贴从 API Keys 页面右侧复制的账号 ID。
  4. 点击连接按钮完成接入。
  5. 当 Wix 卡片显示已连接状态时，即表示连接成功。

快速操作步骤汇总

如果您只想快速完成配置，可以按以下顺序操作：

  1. 登录 Wix，进入 Account Settings -> API Keys。
  2. 点击 Generate API Key，填写名称并设置权限。
  3. 点击 Generate Key，复制弹窗中的 Token。
  4. 进入目标站点 Dashboard，从地址栏复制 Site ID。
  5. 回到 API Keys 页面右侧，复制 Account ID。
  6. 将 API Key、Site ID、Account ID 依次填入 StoreClaw 的 Wix Connector。

常见问题 (FAQ)

Q：为什么我的账号看不到 Generate API Key 按钮？

A： 通常只有账号的 Owner 或 Co-owner 才能创建 API Key。普通 Collaborator 没有此权限。请联系账号 Owner 协助创建，或将您的角色提升为 Co-owner。

Q：关闭弹窗后忘记复制 Token 怎么办？

A： Wix 出于安全原因不会再次显示完整 Token。您需要回到 API Keys 页面，找到对应 Key，点击右侧菜单删除旧 Key，然后重新生成一个新的 API Key。

Q：Site ID 在哪里找？

A： 进入对应站点的 Wix Dashboard，查看浏览器地址栏。URL 中 /dashboard/ 和 /home 之间的 UUID 字符串就是 Site ID。

Q：API Key、Site ID、Account ID 分别是什么？

A： 三者用途不同：API Key 用于身份验证；Site ID 用于标识具体站点；Account ID 用于标识整个 Wix 账号。StoreClaw 连接 Wix 时，这三项都需要填写。

Q：一个账户可以创建多个 API Key 吗？

A： 可以。Wix 支持创建多个 API Key，适合为不同应用或团队成员分别配置独立密钥，方便权限管理和单独撤销。

Q：如何撤销或更新 API Key？

A： 进入 API Keys 页面，找到对应 Key，点击右侧菜单并选择删除，即可让该 Key 立即失效。如需更新，删除旧 Key 后重新生成即可。