wix

用途

本技能封装了 Wix 平台的 API，用于对 Wix 网站进行程序化管理。当用户提到 Wix、wix.com、wixsite.com、分享 Wix 链接、Wix 站点或询问 Wix CMS 时适用。

主要能力

站点信息

获取站点实例信息，包括 instanceId、appName、站点显示名称与所有者邮箱。

接口示例：

curl -s "https://www.wixapis.com/apps/v1/instance" --header "Authorization: Bearer $WIX_TOKEN" | jq '{instanceId: .instance.instanceId, appName: .instance.appName, siteName: .site.siteDisplayName, ownerEmail: .site.ownerEmail}'

CRM 联系人管理

需要站点启用 CRM 功能，包括：

• 搜索联系人（POST https://www.wixapis.com/crm/v3/contacts/search）
• 获取单个联系人（GET https://www.wixapis.com/crm/v3/contacts/<contact-id>）
• 创建联系人（POST https://www.wixapis.com/crm/v3/contacts）
• 更新联系人（PATCH https://www.wixapis.com/crm/v3/contacts/<contact-id>）

创建联系人请求体示例：

{
  "info": {
    "name": {
      "first": "Jane",
      "last": "Doe"
    },
    "emails": {
      "items": [
        {
          "email": "jane.doe@example.com",
          "tag": "MAIN"
        }
      ]
    },
    "phones": {
      "items": [
        {
          "phone": "+1-555-0100",
          "tag": "MOBILE"
        }
      ]
    }
  }
}

博客文章管理

需要站点启用 Blog 功能，包括：

• 列出博客文章（POST https://www.wixapis.com/blog/v3/posts/list）
• 获取单篇博客文章（GET https://www.wixapis.com/blog/v3/posts/<post-id>）
• 创建草稿博客文章（POST https://www.wixapis.com/blog/v3/draft-posts），其中 memberId 字段为可选，若没有具体作者 ID 可省略。

Wix Stores 商店数据

需要站点启用 Wix Stores 功能，包括：

• 查询商品（POST https://www.wixapis.com/stores/v1/products/query）
• 获取单个商品（GET https://www.wixapis.com/stores/v1/products/<product-id>）
• 搜索订单（POST https://www.wixapis.com/ecom/v1/orders/search）
• 获取单个订单（GET https://www.wixapis.com/ecom/v1/orders/<order-id>）

使用方式

所有请求通过 curl 调用 Wix REST API，需要在请求头中携带 Authorization: Bearer $WIX_TOKEN 访问令牌，POST/PATCH 请求需设置 Content-Type: application/json 并通过 -d @文件 传递请求体。常用 jq 对返回值进行字段筛选。

排查方式

若请求失败，可运行以下命令检查连接器：

zero doctor check-connector --env-name WIX_TOKEN

或：

zero doctor check-connector --url https://www.wixapis.com/apps/v1/instance --method GET

适用场景

适用于通过脚本或自动化方式读取和管理 Wix 站点的基本信息、CRM 联系人、博客文章以及商店商品和订单数据。

限制

• 所有 API 端点都要求 Wix 站点已安装 VM0 应用。
• 访问令牌与安装该应用的特定站点绑定。
• CRM、Blog 和 Store API 仅在站点已安装或启用相应功能时才可用。
• 联系人 API 中主邮箱/电话使用 MAIN 标签。
• 关于收费、价格、平台范围或效果等信息，资料中暂未提供。