Theo dõi một giao dịch nghiệp vụ qua các hệ thống kết nối
Một giao dịch có thể đi qua nhiều dịch vụ trong khi từng bảng theo dõi đều báo thành công cục bộ. Kết nối dấu vết kỹ thuật với mã nghiệp vụ bền vững để tìm độ trễ mà không nhầm yêu cầu với kết quả.
Read MoreKiểm thử tích hợp bên ngoài mà không tác động production
Kiểm thử có thể vô tình gửi tin thật hoặc tạo lượt đặt thật. Hãy tách môi trường, hạn chế đích gọi ra và xác minh cơ chế chặn trước khi tin vào một buổi diễn tập tích hợp.
Read MoreQuản lý thông tin xác thực API trong toàn bộ vòng đời
Thông tin xác thực API cần người phụ trách, mục đích và cách thu hồi. Hãy thiết kế cấp phát, lưu trữ, thay thế, giám sát và thu hồi cùng nhau để quyền truy cập không trở thành phụ thuộc vô chủ.
Read MoreKiểm tra dữ liệu nhận vào tại ranh giới hệ thống
Dữ liệu nhập có thể đúng định dạng nhưng vẫn sai quyền sở hữu hoặc quy tắc nghiệp vụ. Kiểm tra cấu trúc, ý nghĩa, quyền và trạng thái quy trình trước khi thay đổi bản ghi hay tạo tác động ngoài.
Read MoreGiới hạn lưu lượng tích hợp mà không che lỗi quan trọng
Giới hạn lưu lượng cần kiểm soát nhu cầu mà không biến tích hợp hỏng thành tồn đọng vô hình. Phân biệt phản hồi hạn mức với lỗi quyền và máy chủ, đồng thời hiển thị công việc bị chậm.
Read MoreChuẩn bị timeout và retry cho dịch vụ phụ thuộc bên ngoài
Timeout giới hạn thời gian chờ, không nhất thiết dừng thực thi từ xa. Quy tắc thử lại cần dựa trên hạn tổng, idempotency nghiệp vụ, sức chịu tải và cách khôi phục kết quả chưa rõ.
Read MoreGiữ phân trang nhất quán khi dữ liệu thay đổi
Phân trang có thể âm thầm bỏ sót hoặc lặp bản ghi khi dữ liệu đang thay đổi. Hãy chọn thứ tự, cách tiếp tục và quy tắc ảnh chụp phù hợp với việc duyệt dữ liệu hay xuất đầy đủ.
Read MoreChọn polling hay webhook theo nhu cầu vận hành
Polling và webhook chuyển chi phí và trách nhiệm xử lý lỗi sang những vị trí khác nhau. Hãy chọn theo độ mới dữ liệu, khả năng bên gửi, giới hạn mạng và năng lực khôi phục thực tế.
Read MoreThay đổ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 More