Trình dựng bộ test API

Kỹ năng này làm gì

Dò tìm các endpoint API trong mã nguồn, lập ma trận test cần thiết cho từng endpoint và xuất ra file test chạy được ngay.

• Dò route tự động: Next.js App Router (app/api/**/route.ts), Express (router.get/post...), FastAPI (@router.get), Django REST (urlpatterns, router.register)
• Ma trận test xác thực: thiếu header (401), token sai định dạng (401), sai vai trò (403), token hết hạn (401), token của user đã xóa (401)
• Ma trận kiểm tra đầu vào: body rỗng, thiếu trường bắt buộc, sai kiểu dữ liệu, giá trị biên (min-1 / min / max / max+1), payload SQL injection và XSS, giá trị null
• Phủ mã lỗi: 400/401/403/404/422/500 cho từng route
• Phần mở rộng: phân trang (trang đầu/cuối/rỗng/quá lớn), upload file (hợp lệ, quá dung lượng, sai MIME, rỗng), rate limit (burst, theo user vs toàn cục)
• Định dạng đầu ra: Vitest + Supertest cho Node, Pytest + httpx cho Python

Kèm theo là danh sách lỗi thường gặp (chỉ test happy path, hardcode ID, chia sẻ state giữa các test) và các thực hành tốt.

Phù hợp với ai

• Lập trình viên backend cần phủ test nhanh cho API cũ chưa có test nào
• Nhóm muốn viết test trước theo TDD khi thêm endpoint mới
• QA / kỹ sư nền tảng chuẩn bị kiểm thử hồi quy trước release hoặc audit bảo mật
• Dự án đang chạy Next.js API Route, Express, FastAPI hoặc DRF

Ví dụ sử dụng

1. Tạo baseline cho server Express cũ — "Quét mọi route trong thư mục src và sinh smoke test bằng Vitest+Supertest": kỹ năng lập bản đồ route rồi tạo file test có describe cho từng endpoint kèm case 401/404.
2. Chuẩn bị audit bảo mật API thanh toán — "Viết test cho POST /api/payments áp dụng đủ ma trận auth và validation": nhận ngay các case token hết hạn, truy cập tài nguyên của người khác (403), giá trị biên của số tiền và payload injection.
3. TDD cho tính năng FastAPI mới — Trước khi code, yêu cầu "đọc file router này và dựng khung test Pytest+httpx": bạn có sẵn khung kiểm tra schema phản hồi và biên phân trang để bắt đầu từ trạng thái đỏ.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục .gemini/skills/api-test-suite-builder từ repo GitHub alirezarezvani/claude-skills vào ~/.claude/skills/api-test-suite-builder/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.