Bạn thiết kế versioning trong API Design như thế nào? /v1/path hay dùng header?
Bạn thiết kế versioning trong API Design như thế nào? /v1/path hay dùng header?
Versioning API:
| Cách | Ví dụ | Ưu/ nhược |
|---|---|---|
| URL path | /v1/orders |
Rõ ràng, dễ cache/ định tuyến, phổ biến nhất; "URL thay đổi" |
Header (Accept: application/vnd.api.v2+json) |
Content negotiation | URL sạch; khó kiểm thử bằng trình duyệt |
| Query | ?version=2 |
Đơn giản; dễ bị bỏ qua |
Ngày (Stripe: Stripe-Version: 2024-06-20) |
Phiên bản theo ngày | Tinh tế, cần hạ tầng |
Đăng nhập để tham gia thảo luận cùng mọi người.
Chưa có bình luận nào
Hãy là người đầu tiên chia sẻ suy nghĩ của bạn.