Webhooks, Outbox & Delta Sync
Đăng ký và xác thực chữ ký Webhook
Phần tiêu đề “Đăng ký và xác thực chữ ký Webhook”Header gửi kèm mọi delivery: X-TrolyPage-Signature: t={unix_ts},kid={key_id},v1={hmac_sha256} (kèm kid_prev/v1_prev trong cửa sổ xoay secret 24h).
Chuỗi ký: "{timestamp}.{raw_body}" dùng HMAC-SHA256 hex digest. Hệ thống áp dụng:
- Lịch retry lũy tiến tới 72 giờ + Dead Letter Queue.
- SSRF validation chặn loopback/link-local/private IP trước khi gửi.
- Circuit breaker tự ngắt tạm thời khi endpoint lỗi liên tiếp quá ngưỡng.
Sync & Async Operations
Phần tiêu đề “Sync & Async Operations”- Đọc delta liên tục qua
GET /v1/sync-changes?cursor=.... - Khởi tạo snapshot khởi đầu qua
POST /v1/sync-snapshots. - Với các tác vụ dài (
customer.merge,knowledge.ingest,commerce.refund,campaign.send), API trả202 AcceptedkèmLocation: /v1/operations/op_...để polling hoặc chờ webhookoperation.status_updated.
