JSON 校验器:检查 Webhook 请求数据

JSON 校验器可在发送 Webhook 请求数据前检查 JSON 语法、定位解析错误,并检查必填文本字段。这款免费工具在您的浏览器本地运行,请求数据不会离开浏览器。

作者:Ai Flowi。发布于 .

在下方粘贴 JSON,然后选择“校验”。属性名和字符串须使用双引号。您也可以在任一输入框中按 Ctrl+Enter 或 Command+Enter。

例如:name,email,request。名称对应顶层属性,区分大小写;点号按字面字符处理。名称前后的空格和重复名称会被忽略。留空可跳过字段检查。

已就绪。选择“校验”以检查示例或您的请求数据。

这款 JSON 校验器检查哪些内容?

  • 语法:浏览器的 JSON 解析器会检查引号、逗号、括号和 JSON 值。对于无效 JSON,结果会显示解析器错误信息,以及从 1 开始计数的行号和列号。如果浏览器提供了位置或行列信息,就使用该信息;否则通过本地扫描定位语法错误。在扫描中,未结束的字符串会指向输入末尾,无效转义或未转义的控制字符会指向出错字符。列号按 UTF-16 代码单元计数。
  • 必填字段:输入字段名称后,根值必须是 JSON 对象。每个指定属性都必须存在于该对象中,且值必须是字符串。缺失属性与非字符串值会分别报告。
  • 格式化:解析后的 JSON 会以两个空格缩进显示,即使必填字段检查未通过也会显示。

操作示例:name、email 和 request

工具中已填入示例。在必填字段输入框中保留 name,email,request,然后选择“校验”:JSON 有效,且三个字段均为字符串。

{
  "name": "Webhook Test",
  "email": "test@example.com",
  "request": "Synthetic test"
}

删除 email,即可看到 缺失字段:email。将 name 设为 123,即可看到 非字符串字段:name。在最后一个值后添加逗号,即可看到无效 JSON 的解析器错误信息及其行号、列号。

这与配方的 422 分支有什么关系

Webhook 到 Google Sheets 配方已于 2026年10月8日 通过生产环境测试,其导入副本也已复测。校验通过 JSON Operations (JQ) 和 Verification Router 执行:有效且通过身份验证的请求返回 200,并添加一行;JSON 格式错误、字段缺失或字段类型无效时,返回 422,不添加数据行。身份验证缺失或无效时,返回 403,不添加数据行。

此工具可帮助您在发送请求前发现语法和简单字段问题。配方的校验更严格:它要求 name 和 request 为非空字符串,并检查 email 的格式。请求数据即使通过此工具的检查,仍可能进入配方拒绝请求的 422 分支。请按照教程配置并测试服务端校验。

限制与浏览器隐私

此工具检查语法以及简单的字段存在性和类型,不执行 JSON Schema 校验。空字符串和非电子邮件地址的字符串也能通过字符串检查。它不会检查嵌套路径、重复属性名、业务规则、身份验证、Webhook 投递或 Google Sheets 写入。数组和基本类型值属于有效 JSON,但在启用必填字段检查时无法通过,因为 Webhook 字段需要一个对象。JSON 格式化使用浏览器的解析器,可能改变数字精度或重复属性;请保留原始请求数据。

请求数据不会离开浏览器:工具不会发出网络请求,也不会将输入保存到浏览器存储中。过大的请求数据可能使标签页变慢或无响应;请使用小样本。本地检查通过并不代表生产环境工作流一定会接受或写入该数据。

在工作流中使用检查结果

阅读Universal Webhook 指南,了解请求方法、身份验证,以及测试与生产环境的行为差异。

搭建工作流

检查示例请求数据后,配置配方的校验逻辑,并在工作区中测试真实请求。

了解 AI Flowi Workflow查看价格