Skip to main content

​
Credit và giới hạn tốc độ

Tối đa 100.000 địa chỉ khi sử dụng API.
Có, việc chỉnh sửa webhook qua API hoặc bảng điều khiển sẽ tốn 100 credit cho mỗi yêu cầu. Điều này áp dụng cho mọi thay đổi, bao gồm thay đổi URL, thêm/xóa địa chỉ hoặc cập nhật loại giao dịch.
Mỗi sự kiện webhook tốn 1 credit khi Helius xử lý và gửi sự kiện đến điểm cuối của bạn. Bạn vẫn bị tính phí bất kể điểm cuối có xử lý webhook thành công hay trả về lỗi.
Mọi thao tác quản lý webhook (tạo, chỉnh sửa, xóa) đều tốn 100 credit cho mỗi yêu cầu khi thực hiện qua API. Chi phí này bao gồm quá trình xử lý cần thiết để cập nhật cấu hình webhook.

​
Các mạng được hỗ trợ

Có. Nếu tạo webhook qua giao diện người dùng, hãy chọn “devnet” cho “Mạng”. Nếu tạo qua Webhook API, hãy đặt tham số “webhookType” thành “rawDevnet”, “enhancedDevnet” hoặc “discordDevnet” tùy theo loại webhook mong muốn.
Không—URL phải có thể truy cập công khai qua HTTPS. Helius không thể truy cập các máy chủ phát triển cục bộ qua URL localhost.

​
Sử dụng webhook

Hãy đặt tiêu đề ủy quyền khi tạo hoặc cập nhật webhook. Helius gửi lại giá trị này trong tiêu đề Authorization khi gửi dữ liệu đến điểm cuối webhook, nhờ đó bạn có thể xác minh tính xác thực của yêu cầu.
Webhook thô trả về dữ liệu giao dịch Solana thông thường trực tiếp từ blockchain. Khi có giao dịch xảy ra với các địa chỉ đang được theo dõi, dữ liệu giao dịch thô sẽ được gửi đến URL webhook của bạn.Webhook nâng cao cung cấp các loại giao dịch do Helius diễn giải. Chúng tôi phân tích hơn 100 loại giao dịch Solana (niêm yết NFT, hoán đổi DeFi, chuyển khoản, v.v.) và trừu tượng hóa chúng theo lược đồ riêng.Hãy sử dụng webhook thô nếu bạn muốn nhận toàn bộ dữ liệu giao dịch mà không có lớp trừu tượng, hoặc webhook nâng cao nếu bạn muốn tích hợp sẵn khả năng phát hiện và phân tích loại giao dịch.
Webhook gửi thông báo ngay sau khi một giao dịch khớp điều kiện được xác nhận trên blockchain.

​
Thử lại

Điểm cuối phải trả về mã trạng thái 200 trong vòng 1 giây để xác nhận đã nhận thành công. Theo phương pháp hay nhất, hãy phản hồi bằng 200 ngay lập tức và xử lý mọi tác vụ theo cách bất đồng bộ — điều này ngăn tình trạng hết thời gian chờ do logic nghiệp vụ chậm.
Helius thử gửi lại khi điểm cuối trả về lỗi 5xx, lỗi 4xx (ngoại trừ 403), hết thời gian chờ hoặc thất bại do lỗi kết nối hay lỗi DNS. Chúng tôi thử lại tối đa 3 lần, với khoảng cách 1 giây giữa mỗi lần thử.Nếu tất cả các lần thử lại đều thất bại, sự kiện sẽ mất vĩnh viễn — không có cơ chế đưa trở lại hàng đợi hoặc chu kỳ gửi lần hai.Theo dõi nhật ký webhook trong Bảng điều khiển Helius để xác định lỗi gửi và điều tra sự cố ở điểm cuối.Chúng tôi cũng cung cấp chính sách thử lại có thể tùy chỉnh cho các gói doanh nghiệp.
Helius có thể gửi cùng một sự kiện webhook nhiều lần. Điều này có thể xảy ra do logic thử lại hoặc sự cố mạng.Trình xử lý webhook phải có khả năng xử lý trùng lặp một cách an toàn — việc xử lý cùng một sự kiện nhiều lần phải tạo ra kết quả giống như khi chỉ xử lý một lần.Để xử lý dữ liệu trùng lặp, hãy dùng chữ ký giao dịch hoặc mã định danh sự kiện duy nhất để theo dõi những sự kiện đã được xử lý.
Điều này phụ thuộc vào loại webhook. Webhook nâng cao không gửi các giao dịch thất bại, nhưng webhook thô bao gồm cả giao dịch thành công và thất bại.

​
Tự động vô hiệu hóa

Helius theo dõi tình trạng của điểm cuối và tự động vô hiệu hóa webhook có tỷ lệ gửi thất bại ≥ 95%. Các gói trả phí (Dev trở lên) được đánh giá trong khoảng thời gian 7 ngày, còn webhook thuộc gói Free được đánh giá trong khoảng thời gian 24 giờ. Điều này ngăn lãng phí các lần gửi đến những điểm cuối không thể truy cập.Các nguyên nhân phổ biến bao gồm URL điểm cuối không thể truy cập, máy chủ liên tục trả về phản hồi lỗi hoặc sự cố mạng/tường lửa chặn dữ liệu gửi từ Helius.
  1. Khắc phục sự cố gốc ở điểm cuối.
  2. Đăng nhập vào Bảng điều khiển Helius.
  3. Tìm webhook đã bị vô hiệu hóa và bật lại.
Bạn cũng có thể bật lại webhook bằng mã thông qua điểm cuối Toggle Webhook API bằng cách gửi yêu cầu PATCH với { "active": true }.
Không. Sau khi được bật lại, webhook bước vào thời gian ân hạn 24 giờ và sẽ không bị tự động vô hiệu hóa trong khoảng thời gian này. Điều này cho bạn thời gian xác minh rằng điểm cuối hoạt động bình thường trước lần đánh giá tiếp theo.
Có — người dùng gói Dev trở lên sẽ nhận được thông báo qua email khi webhook bị tự động vô hiệu hóa. Người dùng gói Free có thể theo dõi trạng thái webhook trong Bảng điều khiển Helius.
Có. Bạn có thể bật hoặc tắt webhook trong Bảng điều khiển Helius hoặc qua điểm cuối Toggle Webhook API. Điều này cho phép bạn tạm dừng việc gửi mà không làm mất cấu hình webhook.

​
Khắc phục sự cố webhook

Dữ liệu thường bị mất khi điểm cuối gặp lỗi, khiến webhook thử lại nhưng cuối cùng vẫn thất bại và dẫn đến mất dữ liệu. Hãy kiểm tra nhật ký webhook trong bảng điều khiển, đảm bảo có đủ nhật ký ở phía máy khách và liên hệ bộ phận hỗ trợ nếu sự cố vẫn tiếp diễn.
Hãy đảm bảo loại giao dịch đã chọn khớp với các giao dịch bạn đang theo dõi. Bắt đầu với loại giao dịch “ANY” để xác định đây là sự cố chung hay do loại giao dịch không khớp. Sử dụng webhook.site để kiểm tra xem sự cố có nằm ở cấu hình điểm cuối hay không.
Webhook TOKEN_MINT chỉ được kích hoạt cho các chương trình cụ thể như Candy Machine V1 và Solana Program Library. Webhook này không bao quát tất cả sự kiện tạo token trên toàn bộ blockchain. Để theo dõi rộng hơn, hãy cân nhắc sử dụng gói đăng ký tài khoản hoặc chương trình tổng quát hơn qua webhook với bộ lọc loại giao dịch “ANY”.

​
Bạn cần thêm trợ giúp?

Contact Support

Nhận trợ giúp từ đội ngũ của chúng tôi qua Discord, trò chuyện hoặc email.

Status Page

Kiểm tra thông tin theo thời gian thực về tính khả dụng và hiệu suất của dịch vụ.