> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 오류 코드 FAQ

> Helius API 요청에 대한 일반적인 오류 코드와 문제 해결 단계에 대한 답변을 얻으세요

## 일반적인 오류 코드

<Accordion title="왜 401 오류가 발생하나요?">
  401 오류는 인증 문제를 나타냅니다. API 키가 정확하고 요청에 제대로 포함되어 있는지(`?api-key=YOUR_API_KEY`) 확인하고, 사용하려는 엔드포인트에 대한 계정 액세스 권한이 있는지 확인하세요.
</Accordion>

<Accordion title="왜 429 오류가 발생하나요?">
  429 오류는 요금 제한을 초과했음을 의미합니다. [요금 제한](https://www.helius.dev/docs/billing/rate-limits)을 확인하고 계획 업그레이드를 고려하거나 애플리케이션에서 요청 제한을 구현하세요.
</Accordion>

<Accordion title="왜 500 오류가 발생하나요?">
  500 오류는 내부 서버 오류입니다. [상태 페이지](https://helius.statuspage.io/)에서 진행 중인 사고를 확인하세요. 문제가 지속되면, 요청 세부 정보를 포함하여 [지원 팀에 문의](https://www.helius.dev/docs/support)하세요.
</Accordion>

<Accordion title="왜 503 오류가 발생하나요?">
  503 오류는 서비스가 일시적으로 이용 불가능함을 나타내며, 주로 높은 부하나 유지 보수로 인해 발생합니다. [상태 페이지](https://helius.statuspage.io/)를 확인하고 잠시 후 다시 시도하세요.
</Accordion>

<Accordion title="왜 504 오류가 발생하나요?">
  504 오류는 게이트웨이 시간 초과로, 일반적으로 요청 처리에 시간이 너무 오래 걸릴 때 발생합니다. 요청 범위를 줄이거나, 페이지네이션을 사용하거나, 쿼리 매개변수를 최적화하는 것을 고려하세요.
</Accordion>

***

## 더 도움이 필요하신가요?

<CardGroup cols={2}>
  <Card title="지원에 문의" icon="headset" href="/docs/ko/support/contact-support">
    Discord, 채팅, 이메일 지원을 통해 팀의 도움을 받으세요.
  </Card>

  <Card title="상태 페이지" icon="wave-pulse" href="/docs/ko/support/status-page">
    실시간 서비스 가용성과 성능 정보를 확인하세요.
  </Card>
</CardGroup>