NetPad表单管理

技能简介

NetPad 提供表单生命周期管理与访问控制能力，支持通过 REST API 进行表单创建、数据提交与查询，同时配备 CLI 工具处理 RBAC 配置和应用市场操作。

业务背景

NetPad表单管理帮助企业快速搭建数据收集入口，从客户调研到内部审批均可自定义表单结构。通过细粒度权限控制，不同团队、角色可安全访问各自的数据范围，避免信息泄露。CLI工具与API能力让技术团队能将其嵌入现有工作流，实现表单创建、数据提交与权限管理的自动化。

落地案例：市场部需要收集展会潜在客户信息，运营人员在NetPad创建包含姓名、公司、意向产品的表单并发布。销售主管通过RBAC配置，仅允许华东区销售查看本区域提交记录。技术团队调用REST API将表单嵌入官网，客户填写后数据实时同步至CRM。IT管理员使用CLI批量调整季度权限变更，无需逐人操作。

能做什么

• 创建带自定义字段的表单并发布
• 向表单提交结构化数据
• 查询、筛选和导出表单提交记录
• 管理用户、用户组与角色权限（RBAC）
• 从应用市场安装 NetPad 扩展

使用说明

1. 安装 CLI 工具

npm i -g @netpad/cli

2. 配置 API 认证

export NETPAD_API_KEY="np_live_xxx"  # 生产环境
export NETPAD_API_KEY="np_test_xxx"  # 测试环境（可提交至草稿）

3. 验证依赖

确保系统已安装 curl 和 jq。

4. 常用操作示例

列出项目：

curl -H "Authorization: Bearer $NETPAD_API_KEY" \
  "https://www.netpad.io/api/v1/projects" | jq '.data[] | {projectId, name}'

创建表单：

curl -X POST -H "Authorization: Bearer $NETPAD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://www.netpad.io/api/v1/forms" \
  -d '{"name":"Contact Form","projectId":"proj_xxx","fields":[{"path":"email","type":"email","required":true}]}'

提交数据：

curl -X POST -H "Authorization: Bearer $NETPAD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://www.netpad.io/api/v1/forms/{formId}/submissions" \
  -d '{"data":{"email":"user@example.com"}}'

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥需妥善保管，避免硬编码在版本控制中
• 测试密钥（np_test_xxx）仅允许提交至草稿状态表单
• 删除表单或提交记录后无法恢复
• RBAC 配置错误可能导致未授权访问

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mrlynn/netpad/SKILL.md
来源类型：GitHub 仓库