API 오류 처리

오류 코드

설명 메시지가 수정되어도 바뀌지 않는 원인의 안정적인 식별자입니다.

설명

내부 코드, 데이터베이스 쿼리, 비밀 정보 또는 불필요한 세부사항을 포함하지 않는 짧고 안전한 설명입니다.

요청 ID

로그에서 처리를 찾고 지원팀에 문의하기 위한 고유 식별자입니다.

추가 데이터

허용 상태, 한도, 현재 상태 또는 안전한 거절 사유입니다.

재시도 가능

처리의 중복 방지 기능을 해제하지 않는 일시적 오류임을 명확히 나타냅니다.

재시도 전 대기

요청 빈도 제한 및 일시적 이용 불가 상황을 위한 권장 지연 시간(초) 또는 HTTP 헤더입니다.

필드 오류

원인 코드, 값 경로 및 안전한 설명이 포함된 문제 필드 목록입니다.

문서 참조

원인과 해결 방법을 설명하는 영구 링크 또는 섹션 식별자입니다.

잘못된 형식, 필수 필드 누락, 지원되지 않는 값, 금액 정밀도 오류 또는 잘못된 요청 구조.

누락되었거나 만료되었거나 유효하지 않은 토큰, API 키, 서명, 요청 타임스탬프 또는 nonce.

클라이언트는 인식되지만 해당 작업에 필요한 역할, 브랜드, 시장 또는 권한이 없습니다.

플레이어, 결제, 라운드, KYC 확인, 제공업체 또는 기타 객체가 존재하지 않거나 클라이언트가 접근할 수 없습니다.

객체의 버전이나 상태가 변경되었거나 처리 식별자가 이미 다른 매개변수와 함께 사용되었습니다.

잔액 부족, 한도 초과, 차단된 플레이어, 금지된 시장 또는 허용되지 않는 상태 전환.

클라이언트, 메서드, 역할 또는 중요 처리에 허용된 요청 수를 초과했습니다.

외부 서비스를 이용할 수 없거나 응답이 느리거나 일시적으로 처리를 받지 않습니다.

내부 세부사항을 노출하지 않으면서 진단용 식별자를 포함하는 예기치 않은 플랫폼 오류입니다.

필드 누락, 잘못된 유형, 지원되지 않는 값, 금액 정밀도 및 여러 오류의 동시 발생.

잘못된 키, 만료된 토큰, 잘못된 서명, 권한 없는 역할, 차단된 IP 및 재사용된 nonce.

전송 전 연결 실패, 처리 접수 후 연결 실패 및 최종 응답 수신 중 연결 실패.

HTTP 429, 권장 대기 시간, 동시 요청 및 제한 종료 후 복구.

이용 불가, 유지보수, 잘못된 응답, 지연된 알림 및 상충되는 상태.

시도 횟수 제한, 대기 시간 증가, 요청의 일시 중단, 통제된 복구 및 수동 에스컬레이션.