Idempotency

Các endpoint ghi công khai chấp nhận header Idempotency-Key. Sử dụng nó để retry an toàn khi hết thời gian chờ mạng hoặc phản hồi 5xx không chắc chắn khiến kết quả của thao tác không rõ ràng.

Hành vi

Khóa mới: Sellfern xử lý thao tác và lưu phản hồi.
Cùng khóa với cùng yêu cầu: Sellfern phát lại phản hồi gốc mà không lặp lại thao tác.
Cùng khóa với yêu cầu khác: Sellfern trả về 422 idempotency_conflict.

Khóa idempotency được giữ trong 24 giờ. Sau khoảng thời gian đó, việc dùng lại cùng một khóa có thể được xem như một yêu cầu mới.

Ví dụ

Endpoint bên dưới chỉ mang tính minh họa. Sử dụng Tham chiếu API V1 để xác nhận endpoint ghi nào có sẵn cho tích hợp của bạn.

curl https://api.sellfern.com/products \
  -H "x-api-key: $SELLFERN_API_KEY" \
  -H "Idempotency-Key: product-create-001" \
  -H "Content-Type: application/json" \
  -d '{"sku":"TSHIRT-BLACK-M","title":"Classic T-Shirt"}'

Hướng dẫn cho agent

AI agent nên tạo một khóa idempotency cho mỗi hành động ghi logic. Nếu cần retry cho cùng một hành động, dùng lại cùng một khóa. Nếu người dùng yêu cầu một hành động khác, hãy tạo khóa mới.

Hướng dẫn cho nhà phát triển

Tích hợp

Hành vi

Ví dụ

Hướng dẫn cho agent

​Hành vi

​Ví dụ

​Hướng dẫn cho agent

Hành vi

Ví dụ

Hướng dẫn cho agent