Common Headers #
모든 EBP REST API 요청은 인증, 요청 무결성, 시스템 호환성을 보장하기 위해 다음의 공통 헤더를 반드시 포함해야 합니다.
Common Headers Specification #
| HEADER NAME | Details & DESCRIPTION |
|---|---|
| Host | ⚪ Optional 서버의 도메인 정보 |
| Content-Type | 🔴 Required 요청 메시지 Body의 데이터 타입 default: application/json; charset=utf-8 |
| Content-Length | 🔴 Required 요청 메시지 Body의 바이트 단위 길이 |
| Accept | 🔴 Required 응답 파일 포맷 default: application/json |
| Accept-Language | ⚪ Optional 브라우저 기반 기본 언어 설정 default: en-US e.g., ko-KR, en-US, ja-JP |
| Time-Zone | ⚪ Optional 응답 시간대 설정 default: UTC e.g., Asia/Seoul, America/New_York, Asia/Taipei, Asia/Bangkok |
| X-System-Language | ⚪ Optional 시스템/개발자용 언어 설정 (공통 응답 메시지, 에러 상세, 후속 API 안내 문구 등에 적용) default: en e.g., ko, en |
| X-Language-Code | ⚪ Optional 최종 사용자용 언어 설정 (결제창 노출 언어 등 서비스 로컬라이징에 적용) default: en e.g., ko, en, ... |
| X-Access-Key | 🔴 Required EBP 시스템 사용을 위한 인증 키 |
| X-EBP-Signature | 🔴 Required SHA256 형식: payload + key 값 (요청 무결성 검증용) |
| X-Division-Code | 🔴 Required 사업부 코드 |
| X-Store-Id | 🔴 Required 스토어 ID |
| X-Channel-Code | 🔴 Required 채널 코드 (EBP와 연동하는 시스템 구분 코드) |
| X-Ric-Code | 🔴 Required 권역 구분 코드 e.g., KIC, AIC, EIC |
| X-Country-Code | 🔴 Required ISO 국가 코드 |
| X-Currency-Code | 🔴 Required ISO 통화 코드 |
EBP 발급 정보 안내 #
[!NOTE] 사전 발급 필수 정보
공통 헤더 중 다음 항목은 API 호출 전 EBP 시스템으로부터 사전에 발급받아야 합니다.
- X-Access-Key: 시스템 접근 권한 확인을 위한 고유 인증 키
- X-Division-Code: 사업부 코드
- X-Store-Id: 스토어 ID
- X-Channel-Code: 채널 코드 (EBP와 연동하는 시스템 구분 코드)
- Hash Key:
X-EBP-Signature생성을 위해 사용되는 비밀키 (헤더에 직접 포함되지 않으며 해싱 과정에서만 사용됩니다.)