Mã idempotency khi tạo đơn từ CRM: gửi lại mà không tạo hai giao dịch

Dành cho người phụ trách triển khai và dữ liệu CRM.

Mạng mất sau khi gửi yêu cầu không cho biết máy chủ đã tạo giao dịch hay chưa. Gửi lại nguyên thao tác có thể tạo hai đơn nếu bên nhận không có cơ chế nhận diện cùng một ý định.

Định danh ý định tạo giao dịch

Mã ổn định cần đại diện cho một thao tác nghiệp vụ, không thay mỗi lần retry. Nếu bên nhận hỗ trợ idempotency, kiểm phạm vi, thời hạn và hành vi khi cùng mã nhưng khác nội dung. Nếu không hỗ trợ, cần cách đối chiếu khoá ngoài và điều kiện duy nhất phù hợp, không chỉ kiểm bằng mắt.

Đối soát trạng thái không chắc

Khi timeout, tra cứu theo khoá đã gửi trước khi quyết định gửi lại. Đừng coi lỗi mạng là bằng chứng thất bại. Nhật ký cần đủ để xác định yêu cầu nhưng không chứa thông tin bí mật hoặc dữ liệu khách không cần thiết.

Tình huống minh hoạ

Giả định gửi tạo đơn mã INT-52, máy chủ ghi xong nhưng phản hồi mất. Retry với mã mới INT-53 có thể thành hai đơn; giữ mã ý định giúp nhận diện đây là một giao dịch.

Mẫu làm việc để áp dụng

Giao ước tích hợp ghi cách sinh khoá, nội dung bất biến, phản hồi lặp, thời hạn giữ khoá và quy trình xử lý xung đột. Thử mất phản hồi sau ghi, không chỉ thử lỗi trước khi gửi.

Đọc kết quả thế nào?

Đếm giao dịch trùng theo khoá nghiệp vụ và các ca còn trạng thái không chắc. Không đánh giá tích hợp chỉ bằng tỷ lệ HTTP thành công.

Ngoại lệ và giới hạn

Cơ chế này phải được cả thiết kế và bên nhận thực hiện đúng. Thêm một trường có tên idempotency ở phía gửi không tự tạo bảo đảm chống trùng.

Bước tiếp theo

Chọn một hồ sơ hoặc tác vụ phù hợp với bài, thử bằng dữ liệu được phép dùng và xác nhận kết quả trước khi mở rộng. Nếu muốn trao đổi cách tổ chức công việc trên Oh CRM, hãy mang theo mẫu đầu vào, đầu ra và điều kiện cần kiểm; tính năng và phạm vi gói cần được xác nhận bằng tài liệu hoặc demo thực tế.

Xem tài liệu thực hành trong thư viện ebook

Trao đổi nhu cầu và trải nghiệm dùng thử

Nguồn đọc thêm và phạm vi tham khảo

Stripe: idempotent requests

Tham khảo định nghĩa và cơ chế trong phạm vi nguồn. Ví dụ, phép tính giả định và mẫu áp dụng trong bài do biên tập đề xuất; không suy khả năng của sản phẩm khác hoặc cam kết kết quả.

Đọc tiếp theo bài toán

Nhập lại dữ liệu không tạo bản trùng: thiết kế khoá đối chiếu trước khi import

Các tình huống, biểu mẫu và cách phối hợp là đề xuất thực hành. Phạm vi triển khai trên Oh CRM cần được xác nhận bằng tài liệu và demo phù hợp, không suy từ công cụ hoặc khả năng của nhà cung cấp khác.