Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
 
← Về danh sách

Hướng dẫn versioning API cho Spring Boot 3

Skill giúp thiết kế và duy trì chiến lược versioning REST API nhất quán trên Spring Boot 3 / Spring Framework 6.

Lập trìnhTrung cấp★ 223⑂ 37Điểm AI 7/10Cập nhật lần cuối: 14 thg 8, 2026

Skill này làm gì

  • Hướng dẫn chọn một chiến lược versioning duy nhất: phân đoạn URL, request header, hoặc tham số media-type, rồi áp dụng nhất quán.
  • Cảnh báo lỗi dùng thuộc tính mapping version (chỉ có ở Boot 4) trên Boot 3.
  • Đưa ra nguyên tắc giữ DTO/controller theo từng version thật mỏng và ánh xạ chúng về cùng một use case ứng dụng, không sao chép logic domain.
  • Yêu cầu tập trung các header Deprecation, Sunset, Link vào response advice/filter, đồng thời duy trì OpenAPI và contract test cho mọi version được hỗ trợ.

Phù hợp với ai

  • Dev backend Java/Spring Boot 3 cần phát hành API v2 mà không phá vỡ tương thích ngược.
  • Team đang có mỗi controller một kiểu versioning khác nhau, khó bảo trì.
  • Người phụ trách API công khai cần xây dựng chính sách deprecation rõ ràng.

Ví dụ sử dụng

  1. "Tôi muốn thêm v2 cho API đơn hàng" → nhận gợi ý cấu trúc /api/v1/orders và /api/v2/orders với controller tách riêng.
  2. "URL phải giữ nguyên, tôi muốn phân version bằng header" → được hướng dẫn resolve header tại biên web rồi route tới handler tương ứng, không nhét điều kiện version vào service.
  3. "Làm sao thông báo khai tử v1?" → được chỉ cách thêm tập trung header Deprecation/Sunset/Link và trả lỗi thống nhất cho version không hỗ trợ.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/rrezartprebreza/spring-boot-skills/HEAD/skills/spring-boot-3/api-versioning/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục skills/spring-boot-3/api-versioning từ repo GitHub rrezartprebreza/spring-boot-skills vào ~/.claude/skills/api-versioning/ 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.

Cài bằng lệnh thủ công

git clone https://github.com/rrezartprebreza/spring-boot-skills.git && mkdir -p ~/.claude/skills && cp -r spring-boot-skills/skills/spring-boot-3/api-versioning ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

  1. Mở terminal và clone repo: git clone https://github.com/rrezartprebreza/spring-boot-skills.git
  2. Tạo thư mục skills nếu chưa có: mkdir -p ~/.claude/skills
  3. Sao chép riêng skill này: cp -r spring-boot-skills/skills/spring-boot-3/api-versioning ~/.claude/skills/
  4. Kiểm tra bằng ls ~/.claude/skills/api-versioning để chắc chắn có file SKILL.md.
  5. Khởi động lại Claude Code, sau đó thử hỏi "cách thêm v2 cho API Spring Boot 3" để skill tự kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT