proto.lib

Vòng đời Deprecation → Sunset của một API endpoint

Gỡ một endpoint an toàn đòi hỏi một quy trình có trình tự: publish bản thay thế và thông báo deprecation kèm ngày sunset cụ thể, phát header Deprecation/Sunset và log usage theo từng client để biết chính xác ai còn gọi, nhắc nhở các client còn lại, brown-out (tắt tạm thời có lịch) trước khi gỡ hẳn, và giữ khả năng rollback tới tận cuộc gọi cuối cùng.

ArchitectureTrung bình2026-08-21
Vòng đời Deprecation → Sunset của một API endpoint

Tags

#api-deprecation#sunset-header#versioning#backward-compatibility#brown-out#api-lifecycle

Tài liệu tham khảo

Mở rộng

Animation gốc là một file HTML tự chứa, có thể nhúng lại ở bất kỳ trang nào khác. Mở file gốc

Liên quan

ArchitectureNâng cao

Event Upcasting khi đổi phiên bản schema

Event đã ghi vào log là bất biến, nhưng code miền nghiệp vụ vẫn tiến hoá: mỗi event mang version tag, và bộ loader sẽ upcast event cũ thành hình dạng mới nhất khi đọc (thêm field mặc định, tách field, suy ra giá trị), để domain code chỉ bao giờ thấy đúng một shape hiện tại.

#event-sourcing#upcasting#schema-migration#versioning
ArchitectureNâng cao

Durable Execution: Replay từ log kết quả

Một workflow engine durable ghi lại KẾT QUẢ của mỗi bước vào một journal; khi process crash, toàn bộ mã workflow được chạy lại từ đầu, nhưng mỗi bước đã hoàn tất chỉ đọc lại kết quả cũ từ journal thay vì thực thi lần nữa — nhờ đó mã workflow phải hoàn toàn deterministic (không đọc giờ hệ thống, không random, không I/O trực tiếp ngoài một step).

#durable-execution#workflow#replay#determinism
ArchitectureTrung bình

Cache Key Versioning: chìa khoá phải mã hoá cả hình dạng dữ liệu

Một cache key an toàn phải mã hoá mọi thứ giá trị phụ thuộc vào: định danh thực thể, phiên bản serialisation/schema, tenant hoặc locale, và biến thể feature-flag — để khi code đổi hình dạng dữ liệu, cache chỉ miss sạch sẽ thay vì trả về một blob mà code mới không parse được.

#caching#cache-key#versioning#schema-evolution