Documentation Index
Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt
Use this file to discover all available pages before exploring further.
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.