SSD React API — มาตรฐานการเรียก API ด้วย Axios และ React Query

บริบท

SSD ใช้ Axios สำหรับ HTTP request และ TanStack React Query สำหรับ server state management ทุกไฟล์ที่เกี่ยวกับ API ต้องเก็บใน src/app/api/ โดยมี 2 วิธีสร้าง API client: ใช้ NSwag (แนะนำ) หรือเขียนเอง

กฎหลัก

1. ไฟล์ API client ทุกไฟล์ต้องเก็บใน src/app/api/
2. ควรใช้ NSwag สร้าง Axios API client เป็นลำดับแรก
3. ไฟล์ React Query hooks ตั้งชื่อตาม Controller และลงท้ายด้วย .query.ts
4. ต้องประกาศ queryKeys เป็น object สำหรับทุก query ไฟล์
5. ต้องจัดการ error response จาก API เสมอ (isSuccess check)

โครงสร้างไฟล์ API