개발 가이드

Quick Start Guide
프로젝트 준비
프로젝트 시작

공통 HTTP 헤더

HTTP 헤더에는 KONA PLATE의 웹 서버로 보내는 REST API 요청과 요청 데이터를 설명하는 메타 정보가 포함됩니다.
그리고 요청 URL과 KONA PLATE의 ASP ID 등이 포함되어 있습니다.
KONA PLATE의 Open API를 이용할 때에는 프로젝트에 발급된 키 값도 함께 포함하여 전송해야 합니다.

요청 Header

필드	타입	길이	MOC	설명
X-KM-User-AspId	STRING	15	MANDATORY	ASP ID - KONA PLATE의 제휴사에게 부여한 ID 입니다. - 샌드박스 프로젝트인 경우, 공통의 ASP ID가 부여됩니다. - 별도 계약을 통해, 커머셜 프로젝트 생성시에는 유니크한 ASP ID가 부여됩니다.
X-KM-Correlation-Id	STRING	20	MANDATORY	전문 추적을 위한 거래번호 - 형식 : yyMMddHH24mmss-xxxxxxx - xxxxxxx : 7자리, Hex String
X-KM-Access-Key	STRING	40	CONDITIONAL	프로젝트에서 생성된 Access Key - Callback API 인 경우는 제외됩니다.
X-KM-Crypto-Key-Id	STRING	32	OPTIONAL	데이터 암복호화 키 - 제휴사가 프로젝트 생성 시 부여되는 ID입니다. - 데이터 암호화 요청 시 필수 입력값입니다. (Data Encryption = Y)
X-KM-Tran-Token	STRING	66	MANDATORY	데이터 무결정 확인 키 - 데이터 무결성을 확인합니다. - 더 자세한 정보는 링크를 참조하세요.
X-KM-Tran-Time	STRING	14	MANDATORY	클라이언트 요청 시간 - 형식 : yyyyMMddHHmmss
X-KM-Time-Zone	STRING	3	MANDATORY	시간대 정보 - UTC, KST ...

응답 Header

필드	타입	길이	MOC	설명
X-KM-Correlation-Id	STRING	20	MANDATORY	전문 추적을 위한 거래번호 - 형식 : yyMMddHH24mmss-xxxxxxx - xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id	STRING	32	OPTIONAL	데이터 암복호화 키 - 제휴사가 프로젝트 생성 시 부여되는 ID입니다. - Callback으로 전달될 경우, 발급된 키 중 가장 먼저 발급된 키를 사용합니다.