Skip to content

Webhooks, Outbox & Delta Sync

This content is not available in your language yet.

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.
  • Đọ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 Accepted kèm Location: /v1/operations/op_... để polling hoặc chờ webhook operation.status_updated.