无需登录 数据私有 本地保存

Webhook载荷美化器 - JSON/XML自动缩进

13
0
0
0

Webhook 载荷美化器

自动检测 JSON/XML 格式,一键美化、压缩、复制。支持 URL 解码,让原始载荷一目了然。

0 字符 0 0 B
等待格式化...

常见问题 & 知识库

Webhook 载荷(Payload)是服务端在触发特定事件时,通过 HTTP POST 请求发送给指定 URL 的数据体。它通常包含事件类型、业务数据和元信息。常见的 Webhook 载荷格式包括 JSON(如 Stripe、GitHub、Slack)和 XML(如部分支付网关、企业系统)。载荷可能经过 URL 编码或包含在 multipart 请求中,使用本工具可以快速将其还原为可读的格式化文本。

JSON(JavaScript Object Notation)是目前最流行的 Webhook 载荷格式,结构紧凑、易读、解析速度快,被大多数现代 API 采用(如 Stripe、GitHub、SendGrid)。
XML(eXtensible Markup Language)是一种更早的标准,支持属性、命名空间和复杂的文档结构,常见于银行、支付网关和政府系统等传统企业应用。
本工具支持自动检测并格式化这两种格式,让您无需手动判断。

如果载荷看起来像 %7B%22name%22%3A%22... 这样的格式,说明它经过了 URL 编码。许多 Webhook 发送方(尤其是表单提交场景)会对载荷进行 URL 编码。请打开本工具的「URL 解码」开关,工具会在格式化前自动进行解码,还原原始数据结构。

这取决于团队规范和个人偏好:
2 空格:适合嵌套较深的 JSON,节省水平空间,前端项目常用。
4 空格:可读性最强,层级结构一目了然,后端和数据分析场景常用。
Tab:每个开发者可以自定义显示宽度,但跨工具展示时可能不一致。
本工具默认使用 4 空格缩进,您可以根据需要切换。对于大多数 Webhook 调试场景,4 空格缩进提供了最佳的可读性。

将载荷粘贴到本工具的输入框中,点击「美化」按钮:
• 如果格式化成功,说明载荷格式正确,JSON 或 XML 语法无误。
• 如果出现红色错误提示,说明存在语法问题(如缺少引号、括号不匹配、XML 标签未闭合等),错误信息会指出大致位置,方便定位修复。
此外,您还可以使用在线工具如 JSONLint 进行更详细的校验。

Webhook 载荷大小通常受限于接收服务器的配置。常见的限制:
Nginx/Apache 默认请求体限制为 1MB。
云函数(如 AWS Lambda)通常限制为 6MB。
Stripe 等服务的 Webhook 载荷通常在几 KB 到几十 KB 之间。
建议保持载荷精简,仅包含必要字段。过大的载荷可能导致超时或被截断。本工具在浏览器本地处理数据,支持处理较大的载荷(建议 5MB 以内以保证流畅体验)。

对于嵌套层级深(超过 5 层)的 JSON,建议:
1. 使用 2 空格缩进 来避免行过长。
2. 使用浏览器的查找功能(Ctrl+F)快速定位关键字段。
3. 关注顶层结构,逐层展开理解数据模型。
本工具的行号显示功能可以帮助您在与团队成员讨论时精确定位到特定行。

XML 中有 5 个预定义实体:&amp;(&)、&lt;(<)、&gt;(>)、&quot;(")、&apos;(')。在格式化 XML 载荷时,这些实体应保持原样,不应被解码。本工具在格式化 XML 时会保留这些实体,确保数据完整性。如果您的载荷中包含了未转义的特殊字符导致 XML 解析失败,请先在源头进行正确的 XML 编码。
✅ 已复制到剪贴板