n8n 2.45.0 bản thử thêm chống tạo trùng khi gọi lại API: giới hạn nào cần nhớ?

Gọi lại yêu cầu tạo dữ liệu có thêm cơ chế kiểm soát

n8n công bố bản 2.45.0 ở trạng thái pre-release ngày 20/10/2026. Trong các thay đổi có hỗ trợ header Idempotency-Key cho yêu cầu POST của Public API, theo PR 40978. Khi một ứng dụng gửi lại cùng yêu cầu vì mất kết nối hoặc hết thời gian chờ, cơ chế này có thể trả lại kết quả thành công đã lưu thay vì chạy lại handler.

Điểm mới hữu ích cho nhóm tích hợp tự tạo workflow hoặc tài nguyên n8n bằng API. Ví dụ một công cụ quản trị gửi yêu cầu tạo workflow thành công nhưng không nhận được phản hồi; nếu gọi lại không kiểm soát, nó có thể tạo bản thứ hai. Bản thử mới bổ sung công cụ xử lý tình huống đó, chưa phải lời khuyên nâng production ngay hoặc bảo đảm không bao giờ có dữ liệu trùng.

Khóa có thời hạn, phạm vi và phản hồi lỗi cụ thể

Theo mô tả PR, khóa được lưu theo người dùng trong 12 giờ. Cùng khóa và cùng yêu cầu trả phản hồi thành công đầu tiên, không chạy handler thêm lần nữa. Nếu dùng cùng khóa cho một yêu cầu khác, API trả 422; nếu yêu cầu đầu đang xử lý, lần gọi lại nhận 409. Khi yêu cầu thất bại, khóa được giải phóng để client có thể thử lại.

Vì chỉ lưu phản hồi thành công, cách xử lý này khác thiết kế ghi lại cả lỗi. Client cần phân biệt xung đột đang xử lý với yêu cầu thay đổi nội dung; không coi mọi phản hồi khác 200 là lý do tạo khóa mới và gửi liên tục. Sau 12 giờ, cũng không thể mặc định cùng khóa còn được giữ như trước.

PR lưu ý body phản hồi được lưu dạng JSON plaintext. Đội triển khai cần xem quyền truy cập kho dữ liệu, chính sách lưu giữ và loại nội dung trả về; không coi đây là bằng chứng dữ liệu được mã hóa riêng cho cơ chế replay. Bài chưa chạy thử release 2.45.0 và không công bố số liệu giảm trùng thực tế.

Quyền API và chống trùng nghiệp vụ là hai lớp riêng

Idempotency-Key không phải khóa đăng nhập. Public API vẫn xác thực bằng API key; các scope chỉ cho phép tài nguyên và hành động phù hợp. Tài liệu n8n nêu cấu hình scope dành cho Enterprise, trong khi key ngoài Enterprise có quyền rộng theo tài khoản; Public API không có trong free trial. Cần kiểm tra gói trước khi hứa cung cấp tính năng cho mọi khách hàng.

Ảnh Create API Key trong bài là giao diện thật của n8n, tư liệu có ngày hết hạn mẫu 21/07/2025 và các scope chỉ đọc. Nó minh họa lớp cấp quyền, không có quyền workflow:create để làm phép thử tạo workflow và không phải nút bật Idempotency-Key. Không có API key thật của khách hàng trong ảnh.

Một workflow có thể tiếp tục gọi CRM, email, MISA hoặc cổng thanh toán. Chống lặp yêu cầu tạo tài nguyên n8n không tự làm các hành động ở dịch vụ khác trở nên duy nhất. Với hóa đơn và tiền, vẫn cần mã nghiệp vụ, khả năng đối soát và quy tắc chống trùng ở phía nhận.

Phép thử nhỏ cần có trước khi đưa vào tích hợp

Friday Works đề nghị dùng instance thử do công ty quản lý và dữ liệu mẫu: gửi lại cùng yêu cầu tạo, đổi nội dung nhưng giữ khóa, gửi trong lúc yêu cầu đầu còn chạy và kiểm tra trường hợp lỗi được phép thử lại. Mỗi trường hợp cần xác nhận cả mã phản hồi lẫn số tài nguyên thực sự được tạo. Đây là đề xuất nghiệm thu, không phải kết quả đã chạy trong bài.

Đội tích hợp cần quy định một khóa cho một ý định nghiệp vụ, lưu quan hệ giữa khóa và yêu cầu, có nhịp chờ phù hợp và đối soát khi không biết kết quả cuối. Không dùng cùng một khóa cho mọi đơn hàng, cũng không đổi khóa ở mỗi lần retry cùng đơn. Theo dõi trạng thái stable và khả năng tương thích trước khi chọn lịch cập nhật production.

Ảnh thân là danh sách API key thật từ tài liệu n8n; cả hai ảnh giữ dữ liệu demo và giấy phép Apache 2.0 kèm Commons Clause v1.0. Tài liệu hình được dùng để giải thích quyền và vòng đời key, không dựng một màn hình phản hồi API hoặc kết quả kiểm thử chưa có.