环境准备

在使用 TTLock n8n 插件之前，需要完成以下准备工作。

前置条件

1. n8n 工作流平台（版本 >= 1.0.0）
   • 自托管部署：推荐在服务器上通过 Docker 免费部署
   • 官方云服务：可使用 n8n.io 提供的 Cloud 版（注：官方提供 14 天免费试用，过期后需付费订阅）
2. 拥有 通通锁 App 账号

你需要在 TTLock 开放平台申请自己的 Client ID 和 Client Secret 才能使用。注册步骤详见 配置凭证。

安装插件

方式一：n8n 界面安装（推荐）

1. 打开 n8n，进入 Settings → Community nodes
2. 点击 Install a community node
3. 输入包名 n8n-nodes-ttlock，点击 Install
4. 重启 n8n 使插件生效

方式二：命令行安装

npm install n8n-nodes-ttlock

安装后重启 n8n 即可。

快速体验

安装完成后，可以通过以下步骤快速体验插件功能。

1. 如何传参

你可以使用webhook，在apifox里面进行传参。

2. 搜索并添加 TTLock 节点，选择操作类型

在 n8n 画布中点击 + 号，搜索 TTLock，点击TTLock进入插件详情，在 Actions 中选择具体操作。

3. 配置凭证

在 Credential 下拉框选择 Create new credential，填写以下信息：

字段	说明	示例
Client ID	在 TTLock 开放平台申请的 client_id	your_client_id
Client Secret	在 TTLock 开放平台申请的 client_secret	your_client_secret
Username	通通锁 App 用户名	your@email.com
Password	通通锁 App 密码	yourpassword

4. 填写参数并执行

你可以选择两种传参方式：

• 固定值 — 直接在节点中填写参数：

• 表达式 — 通过 n8n 表达式从上游节点动态获取参数，适合 Webhook/API 调用场景：

点击 Execute Node 执行节点，即可看到返回结果。

下一步

• 配置凭证 — 在 n8n 中创建 TTLock API 凭证