메시지 구조 및 공통 필드

이 장에서는 모바일 신분증 시스템에서 사용하는 메시지 규격을 설명해요.
모든 메시지는 JSON 형식으로 구성되며, 전송할 때는 base64로 인코딩해요.

모든 메시지는 아래 네 가지 항목을 반드시 포함해야 해요

• type (필수): "mip"로 고정. mobile id platform을 의미해요.
• version (필수): "1.0.0"으로 고정. 메시지 구조가 바뀔 경우 버전 번호로 구분해요.
• cmd (필수): 메시지 고유 번호예요.
• trxcode (필수): verifier와 신분증 앱 사이의 트랜잭션을 구분하는 코드예요.

※ (M): 필수 항목 / (O): 선택 항목

1. 메시지 분류

메시지는 동작 흐름에 따라 다음 네 단계로 나눠요

단계	설명
VP 전처리 단계(100)	QR-CPM, BLE 방식처럼 직접 VP 요청이 어려운 경우, 사전 준비를 위한 요청을 보내요.
VP 요청 단계(200)	VP 제출 요청을 보내요. 이때 프로필(Profile)이나 얼굴 이미지(BI)를 함께 보낼 수도 있어요.
VP 준비 단계(300)	VP 요청 이후 필요한 정보를 추가로 요청해요. 예: 프로필, 이미지 등
VP 제출 단계(400)	최종적으로 신분증 앱에서 verifier에게 VP를 제출해요.
기타(900)	오류 등 위 단계와 무관한 일반 메시지를 처리해요.

2. 핸들러 경로

기본 메시지를 처리하는 URL 경로는 아래와 같아요

종류	Handler 경로	예시 URL
프로필 조회	/mip/profile	http://example.com/mip/profile
이미지 조회	/mip/image	http://example.com/mip/image
VP 제출	/mip/vp	http://example.com/mip/vp
오류 제출	/mip/error	http://example.com/mip/error