地端與雲端串接概念
Part 4：Postman 測試 API
使用 Postman 圖形介面工具
測試 /chat API 端點
Postman
POST Request
JSON Body
🤔 什麼是 Postman？
Postman 是一個 API 測試工具，提供友善的圖形介面，讓你可以：
- 發送各種 HTTP 請求（GET、POST、PUT、DELETE）
- 設定請求的 Headers 和 Body
- 查看伺服器的回應結果
- 儲存和管理常用的 API 請求
💡 為什麼用 Postman？
比起用程式碼測試，Postman 更直覺，適合快速驗證 API 是否正常運作！
比起用程式碼測試，Postman 更直覺，適合快速驗證 API 是否正常運作！
【實作 1】下載並開啟 Postman
1下載 Postman
前往官方網站下載：
https://www.postman.com/downloads/
2安裝並開啟
安裝完成後開啟 Postman。
💡 提示：如果要求登入，可以點「Skip and go to the app」跳過！
【實作 2】建立 POST 請求
1點擊左上角「New」
2選擇「HTTP Request」
3將「GET」改為「POST」
點擊下拉選單，選擇 POST
4輸入 URL
http://localhost:5000/chat
⚠️ 確認：Flask 伺服器必須在運行中！
【實作 3】設定 Body（最重要！）
1點擊「Body」分頁
2選擇「raw」
3右側下拉選單改為「JSON」
4輸入以下 JSON：
{
"message": "你好，請介紹一下你自己"
}
🟢 這是一段正確的 JSON 格式
🟥 常見錯誤：
❌ 只輸入
❌ 使用中文引號
❌ 只輸入
"message": "你好..."（缺少大括號）❌ 使用中文引號
「」（必須用英文引號 ""）
【實作 4】發送請求
1點擊「Send」按鈕
在右側找到藍色的 Send 按鈕，點擊它。
2等待回應
等待幾秒鐘（AI 需要時間思考）...
✅ 預期結果
下方會顯示：
Status: 200 OK
{
"success": true,
"message": "你好！我是 AI 助手..."
}
🎉 成功！API 完全正常運作！
【實作 4】預期畫面
你的 Postman 畫面應該類似上圖，顯示 200 OK 和 AI 回應。
❌ 常見錯誤排解
❌ Could not send request
👉 Flask 伺服器沒有在運行，請確認 CMD 視窗有顯示 Running on...
❌ Connection refused
👉 網址錯誤，確認是 http:// 不是 https://
❌ 400 Bad Request
👉 JSON 格式錯誤，確認有 { } 包起來
❌ 500 Internal Server Error
👉 .env 檔案中的 API Key 可能錯誤
✅ Part 4 完成確認
你學會了：
- ☐ 下載並開啟 Postman
- ☐ 建立 POST 請求
- ☐ 設定 JSON Body
- ☐ 發送請求並查看回應
- ☐ 排解常見錯誤
🎉 太棒了！API 測試成功！進入 Part 5：Python 腳本測試！