部落格
在 Mac 格式化與檢查 JSON:讓 API 回應更容易閱讀
將緊湊的回應整理成易讀 JSON,查找語法錯誤並複製結果,不必傳送到線上格式化網站。
要在 Mac 檢查緊湊的 JSON 回應,請將 JSON 本身貼入 Frset 的 JSON 工具,並選擇格式化。需要恢復精簡版本時,則使用精簡功能。這兩項操作都會檢查 JSON 語法,但不會確認資料是否包含 API 所需的正確欄位或值。
複製回應本文,不要連同周圍日誌一起複製
API 用戶端可能同時顯示狀態文字、標頭與回應本文。格式化工具需要的是 JSON 部分。物件前多了一行「Response received:」,或從訊息中連同程式碼圍欄一起複製,都可能讓原本有效的 JSON 無法解析。
編輯前請保留原始回應。例如,{"project":"demo","enabled":true,"items":[1,2]} 是一個可用來測試流程的小型有效物件。格式化只調整呈現,讓結構更易讀,不會改變它原本要表達的值。
用 Frset 格式化或精簡 JSON
- 開啟 Frset 搜尋,選擇 JSON;若未修改,可使用預設關鍵字
/json。 - 將 JSON 本文貼入工具輸入欄位。
- 選擇 Format 加入易讀的縮排,或選擇 Minify 移除多餘空白。
- 執行工具,檢查結果。
- 將已複製的結果貼到編輯器、API 用戶端或工作筆記。
成功結果會加入 Frset 歷史,並複製到系統剪貼簿。你可以透過剪貼板管理工具找回先前結果,但仍受方案的存取與保留規則限制。工具使用上限也依方案而定。
JSON 格式化在本機執行,不需要 AI 供應商或線上格式化網站。工具調整版面時,會保留鍵的順序、數字字面值與字串內容。精簡只移除用於排版的空白,不會移除字串值內的空格,也不是檔案壓縮或加密。
查找語法錯誤
解析失敗時,請先檢查複製的輸入,不要假設工具應該替你修復。常見問題包括:
- 缺少逗號,或大括號、中括號未成對。
- 在 JSON 要求雙引號的鍵或字串外使用單引號。
- 在最後一個成員或陣列元素後留下尾端逗號。
- 輸入中混入註解、日誌前綴或 HTML 錯誤頁。
- 字串中有未跳脫的引號或換行。
JSON 規格 RFC 8259定義了格式。JavaScript 物件字面值,或允許註解的設定格式,不一定是有效 JSON。請明確修正來源後再試;格式化工具不會替你判斷遺失的值原本應該是什麼。
區分資料易讀與資料正確
格式化成功,代表輸入可被解析,不代表某個識別碼確實存在、時間戳記使用預期單位,或欄位符合接收端 API 的規範。應用程式結構描述與業務規則的驗證,仍應在合適的開發工具中進行。
也請確認值是字串還是數字。將 "0012" 改成 12,即使結果仍可解析,也已改變資料。若日期欄位含有不熟悉的整數,可參考時間戳記轉換指南,另外確認單位與時區。
對重複性的工作,可為重要複製內容取名,或在筆記中保存並維護範例。請見儲存程式碼與設定片段。易讀的回應是除錯的良好起點,但原始請求與 API 行為仍然重要。