octoblu/form-service

form-service

基于JSON Schema的通用表单服务

镜像概述

form-service是一个通用表单服务，通过JSON Schema动态生成表单页面，用户提交表单时数据会发送到指定的URL。该服务可与Octoblu触发器等第三方服务集成，适用于快速构建表单并实现数据提交功能。

核心功能

1. 根据传入的schemaUrl加载JSON Schema，自动生成表单界面
2. 支持将表单提交的数据发送到postUrl指定的地址
3. 提供可选参数formSchemaUrl（自定义表单布局）和bearerToken（身份验证）
4. 可与Octoblu触发器无缝集成，实现自动化工作流

使用场景

• 需要快速生成表单并提交数据到第三方服务的场景
• 与Octoblu触发器结合，构建自动化工作流（如数据收集后触发特定操作）
• 动态生成表单的应用场景（无需手动编写表单代码）

配置说明

参数说明

• schemaUrl（必填）：托管JSON Schema的URL地址，用于生成表单结构
• postUrl（必填）：表单提交时数据发送的目标URL
• formSchemaUrl（可选）：托管表单布局配置的URL地址
• bearerToken（可选）：Meshblu令牌，用于身份验证

示例调用

访问以下URL可生成示例表单：

http://localhost:3000/?schemaUrl=https://gist.githubusercontent.com/sqrtofsaturn/88bba93d271a3c97591880119b16ca63/raw/9373e1ab09e6d7f70e3c05eb1f67c784afc5d6cc/sonos.json&postUrl=https://triggers.octoblu.com/flows/3494aa3d-08c6-46d3-80c8-bb640de992a2/triggers/5860b0d0-3418-11e6-a298-19a48a9ab8ed

JSON Schema示例

推荐将JSON Schema托管在GitHub Gist（使用raw链接），示例如下：

json
{
  "type": "object",
  "title": "Octoblu Sonos - 播放歌曲",
  "properties": {
    "url": {
      "title": "MP3 URL",
      "type": "string"
    }
  }
}

Docker部署示例

Docker Run命令

bash
docker run -d -p 3000:3000 docker.xuanyuan.run/octoblu/form-service

部署后可通过http://localhost:3000访问服务。

Docker Compose示例

yaml
version: '3'
services:
  form-service:
    image: octoblu/form-service
    ports:
      - "3000:3000"