本文提到的工具
邊閱讀邊在瀏覽器中開啟工具,立即試試整個流程。
長網址直接看很難審閱
行銷活動網址或 API 的 GET 請求中,常會排著 ?utm_source=...&utm_medium=...&id=... 這麼多參數。網址短時還能用肉眼看,但值一多,就容易漏掉重複的鍵、拼字錯誤、不需要的追蹤值。

使用 DevToolKits 的 URL 參數 JSON 轉換工具,只要貼上網址或查詢字串,就能以 JSON 格式確認鍵與值。
UTM 檢查的重點
廣告或社群貼文用的網址中,utm_source、utm_medium、utm_campaign 的值會直接影響成效數據。若有大小寫或寫法不一致,分析工具可能會將其計為不同的活動。
發布前,建議對照 JSON 化後的參數,確認是否符合既定的命名規則。
也能用於 API 除錯
API 的 GET 請求中,搜尋條件、頁碼、排序條件等會放在查詢參數。整理成 JSON 後,較容易貼到規格書或 Issue,團隊也更容易重現相同條件。
例如審閱下面這樣的網址時:
https://example.com/search?q=jwt&page=2&sort=updated&tag=security&tag=api
JSON 化後,較容易確認 page 是否以字串傳遞、tag 是否被指定多次、是否混入空值。也能及早發現 API 端期待 tag=security,api、但前端卻送出 tag=security&tag=api 的落差。
若值經過 URL 編碼,可用 URL 編碼/解碼工具 確認字串的意義。
寫進 Issue 時的方式
回報問題時,比起只貼上完整網址,把拆解後的 JSON 與期望值一起留下,能讓重現更快。
{
"q": "jwt",
"page": "2",
"sort": "updated",
"tag": ["security", "api"]
}
這種形式下,可以分別確認「搜尋字詞」「分頁」「排序」「篩選條件」。減少閱讀長網址的負擔,審閱者也能只專注於差異。
編碼與陣列寫法的陷阱
審閱 URL 參數時,編碼與陣列的寫法是容易忽略的地方。
+與%20的差別:在查詢字串中,空白可能被編碼成+(依application/x-www-form-urlencoded規範),路徑部分則使用%20。兩者都代表空白,但若解碼方式弄錯,+就會原樣保留。- 陣列的寫法因服務而異:同樣是「多個值」,有
tag=a&tag=b(重複)、tag=a,b(逗號分隔)、tag[]=a&tag[]=b(中括號)等做法。前端與 API 的前提不一致時,就只有一邊收得到。 - 漏掉編碼:值中含有
&或=卻沒有編碼時,會在該處被切成另一個參數。
轉成 JSON 確認陣列與鍵的形狀,並用 URL 編碼 / 解碼工具 查看編碼後值的原意,就能及早發現這類不一致。
實際的轉換結果
這是把下面的 URL 輸入到 URL 參數轉 JSON 工具所得到的結果。
https://example.com/?utm_source=news&utm_medium=email&tag=a&tag=b&q=%E6%9D%B1%E4%BA%AC&empty=&flag
{
"utm_source": "news",
"utm_medium": "email",
"tag": ["a", "b"],
"q": "東京",
"empty": "",
"flag": ""
}
- 值會被解碼:
q=%E6%9D%B1%E4%BA%AC會顯示為"東京" - 同名的鍵會變成陣列:
tag=a&tag=b是["a", "b"] - 值為空的鍵與沒有
=的鍵,都會變成空字串:empty=與flag沒有區別 - 所有的值都是字串:
page=2也不是數字2,而是"2" a[]=1&a[]=2這類方括號寫法不會被展開:鍵名仍是"a[]",值則是陣列。b[x]=3也是"b[x]": "3"。若想當成巢狀物件來讀,請對照接收端框架的解讀方式- 可以輸入整個 URL、
?之後的部分,或像a=1&a=2這樣只有查詢的部分
結語
URL 參數只要一個小小的輸入錯誤,就會改變成效數據或 API 行為。與其盯著長網址看,光是拆解成 JSON 來確認,就能提升審閱的準確度。
常見問題
含有重複鍵的網址會如何處理?
當同一個鍵出現多次,例如 tag=security&tag=api,JSON 化後會以陣列呈現。這能讓你更容易發現 API 端期待逗號分隔的 tag=security,api、卻收到多個參數的落差。請依規格確認應為哪一種格式。
使用 UTM 參數要注意什麼?
utm_source、utm_medium、utm_campaign 的值會直接成為你的分析結果。大小寫或寫法不一致(如 Twitter 與 twitter)會被計為不同活動。發布前先 JSON 化,確認值符合命名規則較為安全。
值是 %20 這類編碼,看不懂。
URL 參數的值含有保留字元時會被百分號編碼。%20 是空格,%2F 是斜線。用 URL 編碼/解碼工具 解碼,即可確認原始字串的意義。
為什麼空白會變成 +?
在查詢字串中,依 application/x-www-form-urlencoded 規範,空白可能被編碼成 +。路徑部分或符合 RFC 3986 的編碼則使用 %20。兩者都代表空白,但解碼時若沒有考慮這個差異,+ 就會原樣保留,請配合處理該值的系統確認。
