오류 처리
응답 형식
모든 성공 응답은 아래 형식을 따릅니다.
{
"success": true,
"data": { ... },
"timestamp": "2024-01-01T00:00:00.000Z"
}
오류 발생 시:
{
"code": "ERROR_CODE",
"message": "오류 메시지"
}
공통 오류 코드
| HTTP | Code | 설명 |
|---|---|---|
| 400 | HTTP_400 | 잘못된 요청 (파라미터 유효성 오류) |
| 401 | AUTH_REQUIRED | 인증 필요 |
| 403 | HTTP_403 | 접근 권한 없음 |
| 404 | HTTP_404 | 리소스를 찾을 수 없음 |
| 500 | HTTP_500 | 서버 내부 오류 |
도메인 오류 코드
| Code | 설명 |
|---|---|
CERTIFICATE_NOT_FOUND | 인증서를 찾을 수 없음 |
CONTRACT_NOT_DEPLOYED | 컨트랙트가 아직 배포되지 않음 |
CONTRACT_NOT_BURNABLE | 소각 불가능한 컨트랙트 |
RPC_NOT_AVAILABLE | 블록체인 RPC 노드 연결 불가 |
TRANSACTION_NOT_FOUND | 트랜잭션을 찾을 수 없음 |
재시도 정책
| 오류 | 재시도 권장 여부 |
|---|---|
401 | 서명 재생성 후 1회 재시도 |
500 | Exponential backoff (최대 3회) |
RPC_NOT_AVAILABLE | 30초 후 재시도 |
| 그 외 | 재시도 불필요 |