본문으로 건너뛰기

XRPL Error Reference

업데이트됨:
2026년 4월 15일
Quicknode RPC 엔드포인트에 대한 오류 로그를 Quicknode . 대시보드에서 직접 상세한 오류 정보를 확인하여 문제를 손쉽게 파악하고 해결할 수 있습니다.

HTTP 오류 코드

자, 이제 자주 접하게 되는 HTTP 오류 코드와 그 의미, 그리고 이를 방지하기 위해 취할 수 있는 조치에 대해 살펴보겠습니다.

400잘못된 요청

잘못된 HTTP 요청 유형(예: POST 대신 GET 사용) 또는 유효하지 않은 문자

401무단 접근

이는 잘못된 토큰 인증, 화이트리스트에 포함되지 않은 IP, 유효하지 않은 JWT 등 하나 이상의 보안 요구 사항이 충족되지 않을 때 발생할 수 있습니다.

403접근 금지

Endpoint (이유 중 하나는 연체된 결제일 수 있습니다)

403접근 금지 - 사용자 정의 추적 정보를 찾을 수 없음

사용자 정의 추적 코드가 허용 목록에 포함되지 않았습니다(승인 절차를 진행하려면 티켓을 제출해 주세요).

404찾을 수 없음

잘못된 URL 또는 잘못된 메서드

413콘텐츠 용량이 너무 큽니다

요청 본문의 크기가 너무 큽니다

413요청 엔티티 크기가 너무 큽니다

eth_getLogs 및 eth_newFilter는 10,000 블록 범위로 제한됩니다. 로그 및 이벤트를 요청할 때 10,000 블록 범위의 제한을 적용합니다.

429요청이 너무 많습니다

요청의 초당 요청 수(RPS)가 요금제에서 허용하는 한도를 초과했습니다. 429 오류에 대한 자세한 내용은 지원 문서를 참조하십시오.

500서버 내부 오류

Submit a ticket for the support team to take a look at the errors asap

503서비스를 이용할 수 없습니다

Submit a ticket for the support team to take a look at the errors asap

HTTP 오류 코드 예시

아래 코드 조각은 오류 코드 4 29의 예시입니다.

{
	"jsonrpc": "2.0",
	"error": {
		"code": 429,
		"message": "The requests per second (RPS) of your requests are higher than your plan allows."
	},
	"id": 1
}

Endpoint

Quicknode 문제 진단을 돕기 위해 RPC 엔드포인트에 대한 로그를 Quicknode . 다음 경로로 이동하여 Quicknode 직접 로그를 확인할 수 있습니다:


  1. 사이드바의 엔드포인트
  2. endpoint 선택
  3. '로그' 탭 열기

시간 범위, 응답 유형, 메서드 및 네트워크별로 로그를 필터링할 수 있습니다.

어떤 내용이 기록되는가

Endpoint
해당 endpoint로 전송된 요청으로, HTTP 상태, 요청 메서드, RPC 메서드 또는 경로, 타임스탬프 등이 포함됩니다.

오류 세부 정보
가능한 경우, 실패한 요청에는 RPC 오류 코드, 요청 및 응답 본문, 관련 문서 링크와 같은 오류 세부 정보가 포함됩니다.

벌목 제한 사항

로그 가용성은 메서드, 응답 유형, 네트워크 및 요금제에 따라 달라질 수 있습니다. 최적의 endpoint 유지하기 위해 로깅은 ‘최선 노력(best-effort)’ 방식으로 운영됩니다. 낮은 지연 시간을 유지하기 위해 트래픽이 많은 시간대에는 일부 로그가 누락될 수 있습니다.

보존 및 접근

Build 및 Scale 요금제에는 표준 로그 보존 기간이 적용된 대시보드 이용 권한이 포함됩니다. Enterprise 요금제는 더 긴 로그 보존 기간과 로그 조회를 위한 프로그래매틱 API 접근 권한을 제공합니다.

다른 오류 코드가 표시되는 경우, 지원 티켓을 제출하여 알려 주시기 바랍니다. 기꺼이 도와드리겠습니다.