详情

首页手游攻略 如何使用扣子和Webflow API构建轻量级个人作品集自动化生成器

如何使用扣子和Webflow API构建轻量级个人作品集自动化生成器

佚名 2026-07-12 07:24:58

用扣子工作流调用Webflow API可实现GitHub新仓库自动同步至作品集 :先获取Webflow API密钥、站点ID和Projects集合ID;再在扣子中创建含GitHub Webhook接收、数据解析与API提交节点的工作流,并配置条件判断与失败通知。

你想把 GitHub 项目自动同步到个人作品集 ,又不想每次手动更新 Webflow 页面——用扣子(Coze)工作流调用 Webflow API,就能让新提交的代码仓库自动变成网页上的卡片,全程无需写一行部署脚本。

准备工作:获取 Webflow API 密钥与站点 ID

登录 Webflow 账户 → 进入「Account Settings」→ 左侧菜单点「API Tokens」→ 点击「Create Token」。

在弹窗中填写名称(例如“coze-portfolio-sync”),权限勾选 【Sites: Read & Write】【Collections: Read & Write】,其他全部不选——多勾会导致密钥被平台风控拒绝调用。

点击创建后,页面只显示一次完整密钥,立刻复制保存到本地文本文件;关闭页面就再也看不到原始值。

打开 Webflow 编辑器 → 进入你要自动更新的作品集项目 → 地址栏 URL 形如 https://webflow.com/sites/abc123/edit,其中 abc123 就是你的 【Site ID】,记下来。

回到 Webflow 后台 → 进入「Collections」→ 找到或新建名为「Projects」的集合 → 点击进入 → 右上角「Settings」→ 复制该集合的 【Collection ID】(一串字母数字组合,不是名称)。

在扣子中创建工作流并配置触发节点

登录 coze.cn → 进入工作空间 → 点击「+ 新建」→ 选择「工作流」→ 命名「Webflow-Auto-Project-Sync」→ 描述填“监听 GitHub 新仓库并同步至 Webflow Projects 集合”。

画布默认已有「开始」和「结束」节点,先删掉「结束」节点,后续再加。

从左侧节点库拖入一个「HTTP 请求」节点,重命名为「GitHub Webhook 接收」;双击编辑 → 协议选「POST」,路径留空(扣子会自动生成唯一 webhook URL),请求体类型选「JSON」。

点击「启用 Webhook」→ 复制生成的 URL,这个地址将作为 GitHub 的 payload 接收端点。

配置 GitHub Webhook 并验证事件结构

进入你的 GitHub 个人主页 → 「Settings」→ 「Developer settings」→ 「Webhooks」→ 「Add webhook」。

Payload URL 粘贴刚才复制的扣子 webhook 地址;Content type 选「application/json」;Which events would you like to trigger this webhook? → 勾选「Create」(仅监听新仓库创建事件,避免误触发 fork 或 star)。

点击「Add webhook」后,GitHub 会立即发送测试请求;回到扣子工作流 → 点击「GitHub Webhook 接收」节点右上角「调试」→ 查看「最近请求」里的 raw body,确认结构含 repository.full_namerepository.descriptionrepository.html_url 字段——这三个是后续写入 Webflow 所需的最小字段集。

如果 body 为空或字段缺失,说明 GitHub 没有发送成功,检查是否漏勾「Just the push events」旁边的「Let me select inpidual events」并确保「Create」已启用。

解析 GitHub 数据并构造 Webflow 请求体

在「GitHub Webhook 接收」节点下游,拖入一个「代码」节点,重命名为「Build Webflow Payload」。

在代码编辑区粘贴以下 JavaScript:

ret = {
  fields: {
    "name": params.body.repository.full_name,
    "description": params.body.repository.description || "No description provided",
    "link": params.body.repository.html_url,
    "github_url": params.body.repository.html_url,
    "status": "published"
  }
};

这段代码把 GitHub 事件里的关键字段映射成 Webflow Collection Item 所需的 fields 结构;注意 params.body.repository.description 加了空值兜底,否则 Webflow API 会因字段缺失返回 400 错误。

调用 Webflow API 创建新项目条目

在「Build Webflow Payload」节点下游,拖入第二个「HTTP 请求」节点,重命名为「Post to Webflow Projects」。

配置如下:
方法:POST
URL:https://api.webflow.com/v2/sites/【你的 Site ID】/collections/【你的 Collection ID】/items
Headers 添加两行:
  Authorization:Bearer 【你的 Webflow API 密钥】
  Content-Type:application/json

Body 类型选「Raw」→ 内容填:{{#context.code_1.ret#}}(这是扣子语法,表示上游代码节点的输出)。

点击「测试运行」,观察响应状态码是否为 201;如果是 401,检查密钥是否过期或权限不足;如果是 404,核对 Site ID 和 Collection ID 是否抄错——这两个 ID 区分大小写且不能带空格。

添加失败处理与日志反馈

从节点库拖入一个「条件判断」节点,接在「Post to Webflow Projects」之后,设置判断逻辑为:response.status === 201

「是」分支连向一个「结束」节点,标签写「Sync Success」;「否」分支连向另一个「结束」节点,标签写「Sync Failed」。

在「否」分支上,额外加一个「通知」节点(可选飞书/邮件/Webhook),内容填:Webflow sync failed for {{params.body.repository.full_name}}: {{response.statusText}},便于快速定位问题。

保存工作流 → 点击右上角「发布」→ 此时 GitHub Webhook 开始实时接收新仓库事件。

相关资讯
点击查看更多
游戏推荐
推荐专题
热门阅读
推荐下载