API 공통 결과 코드 (RstVal)

GIIP 가이드 시스템의 API 공통 응답 값인 RstVal과 RstMsg에 대한 표준 정의를 안내합니다.

📋 개요

모든 GIIP API는 실행 결과를 추적하기 위해 RstVal(정수형 코드)과 RstMsg(설명 메시지)를 응답 데이터의 최상위 계층에 포함합니다. 이 값들은 데이터베이스의 tDefRst(Result Definition) 테이블에 정의된 표준을 따릅니다.

사용자께서 언급하신 tRstVal은 실제 시스템의 tDefRst 테이블 내 drRstVal 컬럼을 의미하며, API 개발 및 연동 시 아래 정의된 코드를 참조하여 예외 처리를 수행할 수 있습니다.

---

📡 주요 결과 코드 (Major Codes)

RstVal	RstMsg	의미	비고
200	Process has done successfully	성공	표준 성공 응답
400	No data found	잘못된 요청	필수 파라미터 누락 또는 빈 데이터
401	Unauthorized	인증 실패	Access Key/Secret Key 오류 또는 세션 만료
403	Forbidden	권한 없음	요청한 리소스에 대한 접근 권한 부족
404	No data found	찾을 수 없음	요청한 리소스가 존재하지 않음
500	System error	시스템 오류	서버 내부 로직 또는 DB 에러

---

🔍 상세 결과 코드 목록 (tDefRst)

시스템 내부적으로 사용되는 상세 결과 코드 목록입니다. 특정 도메인(포인트, 사용자 가입, 외부 연동 등)에 특화된 메시지가 포함되어 있습니다.

drRstVal	drRstMsg	카테고리
100	Starting Stored Procedure...	시스템
102	Data is not match	유효성
201	Created successfully	생성
204	No content available	데이터
211	It is clean email. go next...	회원가입
212	Already registered user.	회원가입
220	Charge process has done successfully	결제/포인트
221	Point process has done successfully	포인트
230	Buying process has done successfully	구매
250	Prayed successfully	기타
300	Permission error	권한
301	Not enough point	포인트
302	Already data exists.	중복
312	Pre-registered but not have User data.	가입상태
313	Input status is lower than dbStatus.	데이터 무결성
320	It cannot be processed point processing	포인트
330	You have NFT Token already.	NFT/Asset
332	Already sold out.	구매
333	Event item limit reached.	이벤트
390	Already registered this wallet.	지갑/인증
405	Method not allowed	서버/HTTP
409	Conflict: Resource already exists	상태 충돌
410	Gone: Resource no longer available	만료/삭제
420	You don't have enough point	포인트
421	Not same point and point history.	데이터 정합성
502	Bad Gateway: Upstream error	네트워크

---

💡 개발자 팁

• 성공 판별: RstVal이 200인 경우에만 비즈니스 로직을 계속 진행하는 것을 권장합니다.
• 에러 핸들링: 400대 코드는 클라이언트의 요청 수정이 필요함을, 500대 코드는 시스템 관리자의 확인이 필요함을 의미합니다.
• 메시지 활용: RstMsg는 사용자에게 직접 노출하기보다는 개발자 디버깅용으로 활용하고, 사용자에게는 로캘(Locale)에 맞는 별도의 메시지 처리를 권장합니다.

문제 해결

증상	원인	해결
API 응답의 RstVal이 401로 반환됨	Access Key/Secret Key 오류 또는 세션 만료	인증 키를 재확인하고 세션을 갱신한 뒤 요청을 다시 보냅니다.
RstVal이 400 또는 404이고 데이터가 비어 있음	필수 파라미터 누락 또는 조회 대상 리소스 부재	요청 파라미터를 점검하고, 존재하는 리소스 식별자로 재요청합니다.
RstVal이 301/420으로 처리가 중단됨	포인트 부족 등 비즈니스 조건 미충족	RstMsg(예: Not enough point)를 확인하고 선행 조건을 충족한 뒤 재시도합니다.
RstVal이 500/502로 반환됨	서버 내부 로직·DB 오류 또는 업스트림 게이트웨이 오류	클라이언트에서 재시도하지 말고 RstMsg와 함께 시스템 관리자에게 문의합니다.

---

관련 문서:

• API 개요 및 인증
• Sk3 고성능 로깅 API