API 공통 결과 코드 (RstVal)

GIIP 가이드 시스템의 API 공통 응답 값인

RstVal

과

RstMsg

에 대한 표준 정의를 안내합니다.

📋 개요

모든 GIIP API는 실행 결과를 추적하기 위해

RstVal

(정수형 코드)과

RstMsg

(설명 메시지)를 응답 데이터의 최상위 계층에 포함합니다. 이 값들은 데이터베이스의

tDefRst

(Result Definition) 테이블에 정의된 표준을 따릅니다.

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

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 에러

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

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)에 맞는 별도의 메시지 처리를 권장합니다.

관련 문서: