시작하기
1. API 키 생성하기
1
가입 또는 로그인
Helius Dashboard에서 계정을 만들거나 기존 계정에 로그인합니다.
2
API 키로 이동
대시보드 사이드바에서 API 키 섹션으로 이동합니다.
3
새 키 생성
새 API 키 생성을 클릭하고 프로젝트에 대한 설명을 입력합니다 (예: “프로덕션 앱”, “개발 환경”).
4
키 복사 및 보관
API 키를 즉시 복사하여 안전하게 보관하세요. 이동한 후에는 다시 볼 수 없습니다.
2. API 키 사용하기
모든 요청에 API 키를 쿼리 매개변수로 포함시키세요.시작하기 (에이전트용)
에이전트는 Helius CLI를 사용하여 Helius 계정에 프로그래밍 방식으로 가입하고, 프로젝트를 생성하며, API 키를 생성할 수 있습니다. 자세한 지침은 다음을 읽어보세요: https://dashboard.helius.dev/agents.mdHelius CLI 설치하기
키페어 생성
생성된 지갑 자금 확보 (Autopay 전용)
호스팅 결제 링크를 통해 결제하는 경우 이 단계를 건너뛰세요. 호스팅 결제 링크는 기본 가입 방식이며helius signup --resume으로 완료됩니다. 자동 결제(--pay)는 로컬 키페어에서 결제합니다. 플랜 금액에 해당하는 USDC(Agent 플랜은 $10)와 약 0.001 SOL을 이전 단계에서 확인한 지갑 주소로 전송하세요.
가입 및 API 키 받기
Agent 플랜을 포함한 모든 신규 가입에는--email, --first-name 및 --last-name이 필요합니다. 지갑은 결제에만 사용됩니다.
보안 모범 사례
Environment Variables
API 키를 소스 코드가 아닌 환경 변수에 저장하세요.
IP Restrictions
특정 IP 주소나 범위로 액세스를 제한하려면 대시보드에서 API 키의 IP 제한을 설정하세요.
Separate Keys
사용 환경을 분리하고 보안을 강화하려면 개발, 스테이징 및 프로덕션 환경에 서로 다른 API 키를 사용하세요.
Monitor Usage
비정상적인 패턴이나 잠재적인 보안 문제를 감지할 수 있도록 대시보드에서 API 사용량을 정기적으로 확인하세요.
비밀 정보 관리
- Node.js
- Python
- Docker
사용량 제한 및 사용량
사용량 제한은 구독 플랜에 따라 다릅니다. 할당된 한도를 초과하지 않도록 Helius 대시보드에서 사용량을 모니터링하세요.
사용량 제한 이해하기
- 초당 요청 수: 구독 등급에 따라 결정됩니다
- 월간 요청 할당량: 결제 주기당 허용되는 총 요청 수입니다
- 버스트 허용량: 기본 사용량 제한을 단기간 초과하는 트래픽 급증을 허용합니다
사용량 제한 처리하기
문제 해결
Invalid API Key Error
Invalid API Key Error
증상: 401 Unauthorized 또는 “잘못된 API 키” 오류해결 방법:
- API 키가 올바르고 재생성되지 않았는지 확인하세요
- API 키를 쿼리 매개변수로 포함했는지 확인하세요:
?api-key=YOUR_KEY - API 키에 불필요한 공백이나 문자가 없는지 확인하세요
- API 키가 만료되거나 취소되지 않았는지 확인하세요
Rate Limit Exceeded
Rate Limit Exceeded
증상: 429 Too Many Requests 오류해결 방법:
- 대시보드에서 현재 사용량을 확인하세요
- 재시도 로직에 지수 백오프를 구현하세요
- 더 높은 한도가 필요하면 플랜 업그레이드를 고려하세요
- 불필요한 호출을 줄이도록 요청을 최적화하세요
Forbidden Access
Forbidden Access
증상: 403 Forbidden 오류해결 방법:
- IP 제한으로 인해 요청이 차단되고 있지 않은지 확인하세요
- 구독에 해당 엔드포인트에 대한 액세스 권한이 포함되어 있는지 확인하세요
- API 키에 필요한 권한이 있는지 확인하세요
다음 단계
Quickstart Guide
Helius를 사용해 첫 API 호출을 시작하세요
API Reference
사용 가능한 모든 엔드포인트와 메서드를 살펴보세요
Rate Limits
사용량 제한과 업그레이드 옵션을 알아보세요
Dashboard
API 사용량을 모니터링하고 키를 관리하세요
지원
인증과 관련하여 도움이 필요하거나 API 키에 대해 궁금한 점이 있으신가요?Discord Community
실시간 도움과 커뮤니티 지원을 받으려면 Discord에 참여하세요
Email Support
지원팀에 직접 문의하세요