如何排查 REST API 响应
按顺序处理 JSON 格式化、Base64 解码、URL 解码和时间戳转换,更高效地读懂 API 响应。
REST API 响应里经常会混杂压缩后的 JSON、Base64 字段、URL 编码参数以及 Unix 时间戳。真正高效的排查方式不是盲看原始返回值,而是按层拆开,逐步还原出可读结构和上下文信息。
先把压缩 JSON 还原成可读结构
很多 API 为了减小体积会返回单行 JSON,这虽然合法,但几乎不适合人工排查。对象层级、数组内容和字段关系都会被挤在一起。
先把响应贴进 JSON Formatter 中进行格式化,确认结构是否符合预期。如果工具直接报出语法错误和行号,就应该先修复 JSON 本身,而不是继续猜测业务字段的问题。
识别并解码 Base64 字段
有些接口会把二进制内容、缩略图、签名片段或 token 以 Base64 字符串的形式塞进 JSON 里。遇到长串看不懂的字符时,不要急着判断它是不是脏数据。
把对应字段单独复制到 Base64 Decoder 中,先确认它还原后是文本还是二进制。如果结果仍然像文件头或图片数据,那往往说明这个字段本来就是文件内容的一部分,并不代表接口异常。
本节相关工具
还原 URL 编码参数
redirect、callback 或 webhook 参数里经常会出现 %3A、%2F、%3D 这样的编码内容。只看原始字符串时,很难快速判断真正的目标地址和参数值。
把它交给 URL Decoder 之后,你可以马上看到真实的 URL 结构。如果解码一次后仍然异常,尤其是包含 token 或嵌套 URL 的场景,要继续检查是否发生了双重编码。
本节相关工具
把时间戳转换成真正的时间上下文
API 返回的时间戳可能是秒,也可能是毫秒。只盯着一串数字,通常无法判断事件的先后关系和时间跨度。
Timestamp Converter 可以帮助你同时查看 UTC、本地时间和 ISO 8601 格式。把关键事件的开始和结束时间都转换出来,往往能更快看出重试、超时或延迟链路发生在哪个时间窗口里。
JSON Formatter – Beautify & Pretty Print JSON Online
A high-performance, strictly local JSON formatter and validator with beautiful syntax highlighting. Format or minify your JSON instantly.
Base64 Encoder / Decoder
Encode text or files to Base64, or decode Base64 strings back to plain text.
URL Decoder
Decode percent-encoded URL strings back to human-readable plain text.
Epoch Timestamp Converter
Quickly convert Unix epoch timestamps to human-readable dates and local times, and vice versa.