第一支請求
這一頁用一支公開測試 API,帶你發出第一個 GET 請求、看懂回應,再送出一個帶 Body 的 POST 請求。
發送 GET 請求
- 點左上角 New → HTTP Request,或直接用分頁列的
+。 - 方法選
GET,網址列輸入https://jsonplaceholder.typicode.com/users/1。 - 按右邊的 Send。
送出後,下方會出現:
- 狀態碼:
200 OK代表成功;4xx通常是請求本身有問題,5xx是伺服器端錯誤。 - Time/Size:這次請求花了多久、回應資料多大,抓效能問題很有用。
- Body:預設用 Pretty 模式把 JSON 排版好,方便閱讀;也可以切到 Raw 看原始字串,或 Preview 直接渲染 HTML。
Params、Headers、Body
- Params:URL 上
?key=value的查詢參數,Postman 會自動同步到網址列,不用手動拼字串。 - Headers:例如
Content-Type: application/json、Authorization: Bearer xxx。常用的 Header,Postman 也提供下拉建議。 - Body:
POST/PUT/PATCH常見會帶 Body,型別選raw+JSON,就能直接貼 JSON 物件。
發送 POST 請求
- 新增一個請求,方法選
POST,網址填https://jsonplaceholder.typicode.com/posts。 - 切到 Body 分頁,選
raw,右邊格式選JSON,貼上:
- 按 Send,正常會收到
201 Created,回應內容會回傳剛剛送出的資料,並多一個伺服器產生的id。
常見錯誤排查
| 現象 | 可能原因 |
|---|---|
收到 404 Not Found |
網址打錯、路徑少了 / 或資源不存在 |
收到 401 / 403 |
缺少或錯誤的 Authorization,見 身分驗證 |
收到 400 Bad Request |
Body 格式錯誤,例如 JSON 少了逗號、Content-Type 沒設對 |
| 一直轉圈沒有回應 | 網址是 http 但伺服器要求 https,或本機服務沒有啟動 |