Skip to main content
Cấu hình URL nhận báo cáo tại cột Webhook DLR của API key trong Console. AdFlex gửi một request khi tin được giao thành công.

Xác thực chữ ký

Tính hmac_sha256(rawBody, api_key) trên body thô, so sánh với header X-Zgateway-Signature bằng phép so sánh timing-safe.
Chữ ký tính trên chuỗi byte nguyên bản của request. Parse JSON rồi serialize lại để tính HMAC sẽ cho kết quả sai do khác thứ tự khoá và khoảng trắng.

Quy tắc

Webhook không được gửi cho tin thất bại. Hệ thống chỉ dựa vào webhook sẽ không phát hiện được tin lỗi. Bổ sung tác vụ định kỳ tra cứu qua GET /api/v1/messages.
Xử lý webhook nên idempotent theo message_id để chịu được trường hợp nhận trùng.
Đối soát định kỳ