Thay đổi API mà không làm bên sử dụng bị bất ngờ
Một chỉnh sửa nhỏ của API có thể thay đổi hành vi phía sử dụng hiện có. Hãy đánh giá tương thích theo giả định thực tế của ứng dụng, rồi chuẩn bị chuyển đổi, theo dõi và quay lui.
Read MoreTrả lỗi API để phía sử dụng biết cách xử lý
Phía sử dụng cần phân biệt yêu cầu có thể sửa với sự cố tạm thời của dịch vụ phụ thuộc. Hãy thiết kế loại lỗi ổn định, chi tiết an toàn và hướng xử lý rõ thay vì dựa vào thông báo tự do.
Read MoreThiết kế nhận webhook có tính đến gửi lại và trùng lặp
Nhận webhook không đồng nghĩa với hoàn tất nghiệp vụ. Luồng nhận cần xác thực thông điệp, lưu công việc bền vững và xử lý sự kiện lặp hoặc sai thứ tự mà không âm thầm bỏ mất thao tác.
Read MoreTránh thao tác nghiệp vụ trùng lặp với yêu cầu idempotent
Mất phản hồi khiến phía gọi không biết thao tác nghiệp vụ đã xảy ra hay chưa. Cần xác định danh tính lần thử lại, thời hạn lưu và biện pháp chống trùng ở hệ thống phía sau.
Read MoreThống nhất hợp đồng API trước khi phát triển song song
Các nhóm làm song song cần nhiều hơn danh sách endpoint. Hãy thống nhất ý nghĩa dữ liệu, cách xử lý lỗi và trách nhiệm duyệt trước khi khác biệt xuất hiện ở bước tích hợp.
Read MoreChuyển giao kiến thức hỗ trợ mà không phụ thuộc một người
Chuyển giao hỗ trợ có hiệu quả khi người khác chẩn đoán và hành động được, không chỉ khi tài liệu tồn tại. Tổ chức kiến thức theo triệu chứng, giới hạn quyền, kiểm tra phục hồi và thực hành để tránh phụ thuộc người xây dựng.
Read MoreThử triển khai trên nhóm nhỏ với điều kiện dừng rõ ràng
Thử triển khai cần lý do dừng bên cạnh kế hoạch mở rộng. Xác định nhóm tham gia, thời gian quan sát, dấu hiệu ảnh hưởng người dùng và thẩm quyền phục hồi trước khi cho nhóm nhỏ dùng hành vi mới.
Read MoreDùng retrospective để cải tiến cách phối hợp
Retrospective cần tạo thay đổi có thể thử, không chỉ thêm danh sách bức xúc. Dùng sự kiện quan sát được để chọn một thỏa thuận phối hợp, thiết kế thử nghiệm nhỏ và xem hành vi mới có hữu ích không.
Read MoreLàm rõ nợ kỹ thuật trong quyết định sản phẩm
Nợ kỹ thuật có thể xử lý khi khách hàng thấy ràng buộc cụ thể mà nó tạo ra. Mô tả luồng bị ảnh hưởng, bằng chứng và phương án sửa có giới hạn để cân đối tính năng mới với việc tiếp tục xử lý tạm.
Read MoreƯu tiên lỗi theo tác động và khả năng tái hiện
Ưu tiên lỗi cần xét hậu quả với người dùng, phạm vi ảnh hưởng và cách phục hồi mà không bỏ qua chất lượng bằng chứng. Tách tác động khỏi khả năng tái hiện để lỗi nghiêm trọng không thường xuyên vẫn được điều tra.
Read More