Webhooks, Outbox & Delta Sync
This content is not available in your language yet.
Đă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.
