ทดสอบ API ด้วย curl (ก่อนเขียนโค้ดจริง)

---
name: api-tester-curl
description: ยิง API endpoint ด้วย curl อ่าน response แล้วช่วย debug auth/headers/payload จนได้ผล — ใช้เมื่อต้องเทส REST/webhook, เชื่อม API ที่ไม่เคยใช้, หรือ endpoint ตอบ error แล้วไม่รู้ว่าพังตรงไหน
allowed-tools: Bash, Read
---

# ทดสอบ API ด้วย curl (ก่อนเขียนโค้ดจริง)

## Workflow
1. รวบรวมข้อมูล: method (GET/POST/...), URL, auth (Bearer / API key / Basic), headers, body (JSON/form)
2. **เก็บ secret ใน env var ไม่ใส่ในคำสั่งตรงๆ** เช่น `export API_KEY=...` แล้วอ้าง `$API_KEY` — กัน key หลุดใน history/log
3. ประกอบ curl โดยใส่ `-s -w '\nHTTP %{http_code} | %{time_total}s\n'` เสมอ เพื่อเห็น status + เวลา; POST ใช้ `-H 'Content-Type: application/json' -d '{...}'`
4. รัน แล้วอ่าน response — ถ้าเป็น JSON ส่งผ่าน `| jq .` (ถ้ามี) ให้อ่านง่าย
5. ถ้า error → ไล่ตามตาราง debug ด้านล่าง แก้ทีละอย่าง ยิงซ้ำ
6. เมื่อสำเร็จ (2xx) → สรุปโครง response สำคัญ และถ้าผู้ใช้ขอ ให้แปลงเป็นโค้ด `fetch` (JS) หรือ `requests` (Python) ที่อ่าน key จาก env เหมือนกัน
…