478254400a
- Updated service template structure in `ARCHITECTURE.md` and `README.md` for clarity and usability. - Enhanced bilingual documentation across skills, increasing the number of available skills from 15 to 25. - Added new sections on event-driven architecture, inter-service communication, and performance optimization. - Improved formatting and removed outdated references to streamline the documentation experience.
1.7 KiB
Chiến Lược Versioning API (API Versioning Strategy)
API versioning strategies for GoodGo microservices including semantic versioning, backward compatibility patterns, API deprecation, version negotiation, and breaking changes handling.
Các chiến lược versioning API cho GoodGo microservices bao gồm semantic versioning, backward compatibility patterns, API deprecation, version negotiation, và xử lý breaking changes.
Tổng Quan
API versioning strategies enable managing API evolution while maintaining compatibility and clearly communicating changes to consumers.
Các chiến lược versioning API cho phép quản lý sự phát triển API đồng thời duy trì tương thích và giao tiếp rõ ràng các thay đổi tới consumers.
Khi Nào Sử Dụng
Use this skill when versioning APIs, handling breaking changes, or implementing deprecation.
Sử dụng skill này khi versioning APIs, xử lý breaking changes, hoặc implement deprecation.
Các Patterns Chính
URL Path Versioning / Versioning Theo Đường Dẫn
// EN: Version routes
// VI: Routes theo version
router.use('/v1', v1Router);
router.use('/v2', v2Router);
Deprecation / Deprecation
// EN: Deprecation headers
// VI: Headers deprecation
res.setHeader('Deprecation', 'true');
res.setHeader('Sunset', '2024-12-31');
Best Practices / Thực Hành Tốt
- Choose strategy and be consistent / Chọn chiến lược và nhất quán
- Use semantic versioning / Sử dụng semantic versioning
- Always deprecate before removing / Luôn deprecate trước khi xóa
Tài Nguyên
- Skill Source:
.cursor/skills/api-versioning-strategy/SKILL.md