Skip to main content
Helius API sử dụng khóa API để xác thực yêu cầu. Mỗi yêu cầu API phải bao gồm khóa API để xác minh danh tính và quyền của bạn.
Khóa API là thông tin nhạy cảm cấp quyền truy cập vào tài khoản Helius của bạn. Tuyệt đối không để lộ khóa trong mã phía máy khách, kho lưu trữ công khai hoặc các khu vực có thể truy cập từ trình duyệt.

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.md

Cà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ằng helius signup --resume). Autopay (--pay) thanh toán từ cặp khóa cục bộ: gửi 1 USDC và 0.001 SOL đến địa chỉ ví được cung cấp ở Bước 2.

Đăng ký và nhận khóa API

Các phương pháp bảo mật tốt nhất

Environment Variables

Lưu trữ 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 giới hạn IP cho khóa API trong bảng điều khiển để chỉ cho phép truy cập từ các đị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 để cô lập hoạt động sử dụng và tăng cường 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ý bí mật

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 đăng ký của bạn
  • Hạn ngạch 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 tăng đột biến cho phép: Lưu lượng 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ố

Triệu chứng: 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 bạn đã thêm khóa API 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
Triệu chứng: 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ế chờ lũy thừa 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 yêu cầu để giảm các lệnh gọi không cần thiết
Triệu chứng: Lỗi 403 ForbiddenGiải pháp:
  • Xác minh các giới hạn IP không chặn yêu cầu của bạn
  • 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