오류 코드 및 메시지 구조

모바일 신분증 시스템에서 발생 가능한 오류 코드와 그 구조를 상세히 설명합니다.

오류 코드

코드	이름	설명
형식 오류
10001	unexpected message format	JSON 형식이 아님
10002	missing mandatory item	필수 항목 누락
10003	base64 decode error	base64 디코딩 실패
데이터 오류
10100	invalid data	유효하지 않은 필드 값
10101	invalid type	`"type"` 값이 `'mip'`가 아님
10102	unsupported message version	지원하지 않는 `"version"`
10103	invalid cmd	정의되지 않은 `"cmd"`
10104	trxcode not found	유효하지 않은 `trxcode`
10105	profile create error	프로필 생성 실패
10106~10110	unsupported VP 관련 오류	`presentType`, `encryptType`, `keyType`, `type`, `authType`가 명세와 다름
10111	mismatching nonce	`nonce` 값이 일치하지 않음
10112	mismatching authType	`authType` 값 불일치
절차 오류
10201	message sequence error	메시지 순서 오류
10202	timeout error	처리 시간 초과
거래 정보 오류
10301	database error	데이터베이스 처리 중 오류 발생
10302~10310	거래코드, reqType, svcCode 등 관련 항목 누락 또는 정의되지 않음
BLE 관련 오류
10501	incorrect password	BLE 인증 비밀번호 불일치
기타 오류
99999	unknown error	알 수 없는 오류

코드	이름	설명
형식 오류
20001	unexpected message format	JSON 형식이 아님
20002	missing mandatory item	필수 항목 누락
데이터 오류
20100	invalid data	유효하지 않은 필드
20101	invalid result	`result`가 true/false가 아님
20102	encoding error	인코딩 실패
20103	mismatching trxcode	거래코드 불일치
20104	unsupported image type	지원하지 않는 이미지 형식
절차 오류
20201	message sequence error	메시지 순서 오류
20202	timeout error	처리 시간 초과
20203	unknown disconnect	앱 강제 종료 등으로 인한 연결 끊김
프로필 관련 오류
20300~20308	VC 없음, nonce/필수 필드 누락, 서명 검증 실패 등
영지식 관련 오류 (ZKP)
20401~20403	referent 없음, 조건 불일치, schema 조회 실패 등
API 관련 오류
20501~20503	프로필/이미지 조회 또는 VP 제출 실패
20601	vp proof fail	VP 생성 오류
BLE 관련 오류
20701	incorrect password	BLE 인증 실패
기타 오류
20901	cancel by user	사용자가 요청을 취소함
20903	Transmit size exceeded	허용된 메시지 크기 초과
90001	user authentication fail	사용자 인증 실패 (PIN, 생체인증 등)
90002	Invalid app version	지원하지 않는 앱 버전
99999	unknown error	알 수 없는 오류