# 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

```typescript
// EN: Version routes
// VI: Routes theo version
router.use('/v1', v1Router);
router.use('/v2', v2Router);
```

### Deprecation / Deprecation

```typescript
// EN: Deprecation headers
// VI: Headers deprecation
res.setHeader('Deprecation', 'true');
res.setHeader('Sunset', '2024-12-31');
```

## Best Practices / Thực Hành Tốt

1. Choose strategy and be consistent / Chọn chiến lược và nhất quán
2. Use semantic versioning / Sử dụng semantic versioning
3. 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`