使用 Base64 解碼器快速檢查 API 回應和 Webhook 負載

Dev

在查看 Webhook 日誌或與驗證相關的 API 時,有時會發現部分負載採用 Base64 格式。

雖然表面上看起來像密碼,但 Base64 並不是一種加密,而是一種將資料表達為文字的方式。所以如果你先快速解碼,你會更快找到原因。

在這種情況下,最好直接在瀏覽器中開啟 Dante Tools Base64 工具,並立即檢查從日誌複製的字串。 https://tools.dante.company/zh/tools/base64

這是 Base64 工具使用畫面。
這是 Base64 工具使用畫面。

透過貼上和解碼字串,您可以立即檢查負載是 JSON 還是簡單文字。

什麼時候使用它最好?

最現實的情況是檢查支付 webhook 或外部 API 日誌時。

例如,如果日誌中僅保留如下所示的長字串,請先將其分解為Base64,然後檢查是否包含事件名稱和訂單號碼。

eyJldmVudCI6InBheW1lbnQuc3VjY2VlZGVkIiwib3JkZXJJZCI6Im9yZGVyXzEyMyIsImFtb3VudCI6NDkwMDB9

實用例程

  1. 僅複製日誌中顯示為 Base64 的字串。
  2. 將其貼到您的 Base64 工具的解碼區域中。
  3. 如果結果看起來像 JSON,請將其移至 JSON Formatter 並清理縮排。
  4. 驗證事件名稱、訂單號碼、金額和時間戳記是否符合預期。
  5. 在捕獲或聊天共享之前,必須刪除任何包含令牌或個人資訊的值。

部署前檢查

  • 確保您沒有複製帶有任何引號或空格的字串。
  • 如果解碼結果損壞,請檢查是否為URL安全的Base64以及是否缺少填充字元。
  • 另請仔細檢查您是否未將整個操作令牌貼到外部工具或公共聊天中。

Base64 不是隱藏問題的工具,但通常是調試時需要快速讀取的表示形式。

即使是在瀏覽器中解碼的小例程也可以顯著減少 Webhook 偵錯時間。

前往工具:
https://tools.dante.company/zh/tools/base64

一起使用的好工具:
https://tools.dante.company/zh/tools/json-formatter

原文部落格文章:
https://blog.dante.company/zh-TW/articles/base64-api-debugging-guide