Postman 的 Bulk Edit 是什麼?
在 Postman 的 Params、Headers 或 Body 的 form-data 分頁右側,有一個「Bulk Edit」連結。切換後可以用純文字一次貼上多個欄位,格式是一行一筆 key:value。如果你手上的參數是 JSON(例如從前端程式或 API 文件複製來的),用這個工具轉換後直接貼上,就不用一個一個手動輸入。
如何使用
- 把 JSON 物件貼到左邊的「輸入」框,或按「載入範例」。
- 按「轉換」,右邊會產生 Bulk Edit 格式。
- 按「複製」,到 Postman 的 Params(或 Headers、form-data)分頁按「Bulk Edit」,貼上即可。
轉換規則
| JSON | 轉換結果 |
|---|---|
一般欄位 {"page": 1} | page:1 |
巢狀物件 {"filter": {"q": "abc"}} | filter.q:abc |
陣列 {"ids": [3, 5]} | ids[0]:3ids[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。只有欄位名稱本身不能包含冒號。