Bắt đầu
1. Tạo khóa API
1
Sign up or log in
Tạo tài khoản trên Bảng điều khiển Helius hoặc đăng nhập vào tài khoản hiện có.
2
Navigate to API Keys
Chuyển đến mục API Keys trong thanh bên của bảng điều khiển.
3
Generate a new key
Nhấp vào Create New API Key và đặt tên mô tả cho dự án của bạn (ví dụ: “Ứng dụng sản xuất”, “Môi trường phát triển”).
4
Copy and secure your key
Sao chép khóa API ngay lập tức và lưu trữ khóa một cách an toàn. Bạn sẽ không thể xem lại khóa sau khi rời khỏi trang.
2. Sử dụng khóa API
Thêm khóa API dưới dạng tham số truy vấn trong tất cả các yêu cầu:Bắt đầu (Dành cho tác nhân)
Các tác nhân có thể đăng ký tài khoản Helius, tạo dự án và tạo khóa API theo phương thức lập trình bằng Helius CLI. Để xem hướng dẫn đầy đủ, hãy đọc: https://dashboard.helius.dev/agents.mdCài đặt Helius CLI
Tạo cặp khóa
Nạp tiền vào ví đã tạo (chỉ dành cho Autopay)
Bỏ qua bước này nếu thanh toán qua liên kết thanh toán được lưu trữ (chế độ đăng ký mặc định, được hoàn tất bằnghelius signup --resume). Tính năng thanh toán tự động (--pay) thanh toán từ cặp khóa cục bộ: gửi số tiền của gói bằng USDC (10 USD cho gói Agent) và khoảng 0,001 SOL đến địa chỉ ví ở bước trước.
Đăng ký và nhận khóa API
Mỗi lượt đăng ký mới đều yêu cầu--email, --first-name và --last-name, bao gồm cả gói Agent. Ví chỉ được dùng để thanh toán.
Các phương pháp bảo mật tốt nhất
Environment Variables
Lưu khóa API trong các biến môi trường, không lưu trong mã nguồn.
IP Restrictions
Thiết lập các giới hạn IP cho khóa API trong bảng điều khiển để chỉ cho phép truy cập từ những địa chỉ hoặc dải IP cụ thể.
Separate Keys
Sử dụng các khóa API khác nhau cho môi trường phát triển, thử nghiệm và sản xuất để tách biệt việc sử dụng và cải thiện tính bảo mật.
Monitor Usage
Thường xuyên kiểm tra mức sử dụng API trong bảng điều khiển để phát hiện các mẫu bất thường hoặc vấn đề bảo mật tiềm ẩn.
Quản lý thông tin bí mật
- Node.js
- Python
- Docker
Giới hạn tốc độ và mức sử dụng
Giới hạn tốc độ thay đổi tùy theo gói đăng ký. Theo dõi mức sử dụng trong Bảng điều khiển Helius để đảm bảo không vượt quá giới hạn được phân bổ.
Tìm hiểu về giới hạn tốc độ
- Số yêu cầu mỗi giây: Dựa trên cấp độ gói đăng ký
- Hạn mức yêu cầu hằng tháng: Tổng số yêu cầu được phép trong mỗi chu kỳ thanh toán
- Mức vượt ngưỡng cho phép: Các đợt tăng đột biến trong thời gian ngắn vượt quá giới hạn tốc độ cơ bản
Xử lý giới hạn tốc độ
Khắc phục sự cố
Invalid API Key Error
Invalid API Key Error
Dấu hiệu: Lỗi 401 Unauthorized hoặc “Invalid API Key”Giải pháp:
- Xác minh khóa API là chính xác và chưa được tạo lại
- Kiểm tra xem khóa API đã được thêm dưới dạng tham số truy vấn hay chưa:
?api-key=YOUR_KEY - Đảm bảo khóa API không chứa khoảng trắng hoặc ký tự thừa
- Xác nhận khóa API chưa hết hạn hoặc bị thu hồi
Rate Limit Exceeded
Rate Limit Exceeded
Dấu hiệu: Lỗi 429 Too Many RequestsGiải pháp:
- Kiểm tra mức sử dụng hiện tại trong bảng điều khiển
- Triển khai cơ chế thời gian chờ tăng dần theo cấp số nhân trong logic thử lại
- Cân nhắc nâng cấp gói để có giới hạn cao hơn
- Tối ưu hóa các yêu cầu để giảm những lệnh gọi không cần thiết
Forbidden Access
Forbidden Access
Dấu hiệu: Lỗi 403 ForbiddenGiải pháp:
- Xác minh rằng các giới hạn IP không chặn yêu cầu
- Kiểm tra xem gói đăng ký có bao gồm quyền truy cập vào điểm cuối hay không
- Đảm bảo khóa API có các quyền cần thiết
Các bước tiếp theo
Quickstart Guide
Bắt đầu thực hiện các lệnh gọi API đầu tiên với Helius
API Reference
Khám phá tất cả điểm cuối và phương thức hiện có
Rate Limits
Tìm hiểu về giới hạn tốc độ và các tùy chọn nâng cấp
Dashboard
Theo dõi mức sử dụng API và quản lý khóa
Hỗ trợ
Bạn cần trợ giúp về xác thực hoặc có câu hỏi về khóa API?Discord Community
Tham gia Discord của chúng tôi để nhận trợ giúp theo thời gian thực và hỗ trợ từ cộng đồng
Email Support
Liên hệ trực tiếp với đội ngũ hỗ trợ của chúng tôi