JSON 轉 Postman Bulk Edit

把 JSON 物件轉成 Postman Bulk Edit 的 key:value 格式,可直接貼到 Params、Headers 或表單欄位,巢狀物件與陣列會自動展開。

巢狀物件會展開成 a.b,陣列展開成 a[0],null 會輸出為空值。最外層需為 JSON 物件。

Postman 的 Bulk Edit 是什麼?

在 Postman 的 Params、Headers 或 Body 的 form-data 分頁右側,有一個「Bulk Edit」連結。切換後可以用純文字一次貼上多個欄位,格式是一行一筆 key:value。如果你手上的參數是 JSON(例如從前端程式或 API 文件複製來的),用這個工具轉換後直接貼上,就不用一個一個手動輸入。

如何使用

  1. 把 JSON 物件貼到左邊的「輸入」框,或按「載入範例」。
  2. 按「轉換」,右邊會產生 Bulk Edit 格式。
  3. 按「複製」,到 Postman 的 Params(或 Headers、form-data)分頁按「Bulk Edit」,貼上即可。

轉換規則

JSON轉換結果
一般欄位 {"page": 1}page:1
巢狀物件 {"filter": {"q": "abc"}}filter.q:abc
陣列 {"ids": [3, 5]}ids[0]:3
ids[1]:5
null空值,例如 coupon:
字串中的換行寫成 \n,避免被拆成兩筆

範例

輸入:

{"keyword":"phone","page":1,"filter":{"brand":["Apple","Samsung"],"inStock":true},"coupon":null}

轉換結果:

keyword:phone
page:1
filter.brand[0]:Apple
filter.brand[1]:Samsung
filter.inStock:true
coupon:

常見問題

為什麼最外層必須是 JSON 物件?

Bulk Edit 的每一行都需要一個欄位名稱。最外層如果是陣列或單一數值,就沒有欄位名稱可以對應,所以需要用 { } 包起來。

後端看不懂 ids[0] 這種陣列寫法怎麼辦?

不同後端框架接收陣列的方式不同,有的用 ids[0]=3,有的用重複的 ids=3&ids=5,有的用 ids[]=3。轉換後可以在 Postman 裡直接修改欄位名稱,例如把 ids[0]、ids[1] 都改成 ids。

值裡面有冒號(例如網址)會出錯嗎?

不會。Postman 以每一行的第一個冒號分隔欄位名稱與值,所以 url:https://example.com 會正確解析成欄位 url、值 https://example.com。只有欄位名稱本身不能包含冒號。