Webhook Sự kiện & Cảnh báo thanh lý
Người bán Webhook loại sự kiện, danh tính tạm thời, trường cảnh báo thanh lý và ví dụ về kết quả quỹ.
Trang này theo dõi Agent Java SDK WEBHOOKS.md tại cam kết fa6c7b6. Đây chỉ là bản cập nhật tài liệu; không có tạo phẩm SDK mới nào chứa các phương thức trợ giúp cảnh báo được phát hành.
Tất cả bốn loại sự kiện đều sử dụng lệnh gọi lại được định cấu hình duy nhất của người bán URL (agents.webhook_url). Công văn trên cơ thể event; không cần có cảnh báo riêng URL. Các ví dụ hiển thị cấu trúc tải trọng và không được sử dụng để đưa dữ liệu vào môi trường thử nghiệm.
Sự kiện và sự bình thường
Sự kiện cảnh báo người bán là liquidation.warning; người dùng WebSocket data.event vẫn còn LIQUIDATION_WARNING. Giữ hai kênh riêng biệt.
Thông báo trước đây của người bán đã được sử dụng LIQUIDATION_WARNING. Tải trọng bị đóng băng vẫn giữ nguyên nội dung ban đầu khi thử lại, vì vậy người nhận phải nhận ra cả hai tên. Nếu hồ sơ kinh doanh hiện có sử dụng tiền tố khóa cảnh báo viết hoa, hãy giữ lại khóa gốc hoặc kiểm tra cả hai khóa trong quá trình di chuyển để tránh xử lý lại thông báo.
WebhookVerifier.idempotencyKey hiện tại chỉ trích xuất orderType:orderId:targetStatus cho các sự kiện cấp vốn và trả về một chuỗi trống cho tải trọng cảnh báo. Không có tạo phẩm SDK mới nào chứa các phương thức trợ giúp cảnh báo được phát hành cùng với bản cập nhật tài liệu này. Tiếp tục sử dụng phương pháp verify hiện có để xác minh nội dung cảnh báo thô. Sau khi kiểm tra chữ ký và quyền sở hữu, mã doanh nghiệp của người bán phải nhận dạng cả hai tên sự kiện, xác thực rằng notificationId là chuỗi số nguyên thập phân dương và tạo dựng liquidation.warning:<notificationId>. Không bao giờ sử dụng khóa chống trùng lặp trống hoặc yêu cầu cảnh báo chứa các trường lệnh chuyển tiền.
Duy trì việc loại bỏ trùng lặp trong phạm vi người bán và phạm vi environment và thực hiện nó một cách nguyên tử trong quá trình xử lý kinh doanh. Thông báo FIRST / UPGRADE / REMINDER với các giá trị notificationId khác nhau là độc lập; không loại bỏ chúng bằng cách nhóm theo người dùng, tập hoặc eventType. Khóa trống có nghĩa là không thể trích xuất danh tính hợp lệ. SDK chỉ trả về khóa trợ giúp; nó không lưu giữ hồ sơ hoặc thực hiện xử lý kinh doanh. Ghi nhận cùng một danh tính với một cơ thể khác là xung đột; không ghi đè lên phần thân đã được xử lý.
Các trường và ví dụ cảnh báo thanh lý
Ví dụ về kết quả chuyển giao
Lệnh gọi lại quỹ giữ nguyên các loại hiện có: orderId và agentId là các số JSON; amount và platformUserId là các chuỗi. Không áp dụng quy ước chuỗi agentId của cảnh báo cho các lệnh gọi lại quỹ. Đọc số nguyên lớn mà không mất độ chính xác khi sử dụng kiểu số nguyên/thập phân. completedAt là UTC RFC3339; ts là giây Unix.
Ví dụ về kết quả đảo ngược
Ví dụ về trạng thái chết của lệnh quỹ
Những ví dụ này chỉ hiển thị giao thức. Đối với FAILED, rejectCode, rejectMessage và failReason phản ánh sự từ chối thực tế. Chỉ riêng tên sự kiện không chứng minh được tiền đã được ghi có.