API 문서
전체 API
서비스
보유 마일리지카드 목록 조회동기
버전: v1
버전: v1
/api/v1/mileage/cards/list
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
mileageCardList
array of objects
옵션
마일리지카드 단순정보
mileageCardList_item
object
옵션
cardNo
string
옵션
길이 : 20
마일리지 카드번호
currentCount
string
옵션
최소 : 0 , 최대 : 9999999999999999999
마일리지 카드에 현재까지 누적된 금액
merchantId
string
옵션
최소 : 0 , 최대 : 15
가맹점아이디
policySubType이 "01(단일)"일 때, 가맹점 아이디가 조회됨
merchantType
string
옵션
길이 : 2
가맹점타입
MC : 코나가맹점
policyEnable
string
옵션
길이 : 1
마일리지정책 사용여부
Y : 사용가능 (마일리지 정책의 유효기간 별도 확인 필요)
N : 사용불가 (정책 사용불가 시 마일리지 카드가 활성화 상태여도 적립 불가능함)
policyName
string
옵션
최소 : 1 , 최대 : 50
마일리지정책명
mileageId
string
옵션
길이 : 20
마일리지 정책아이디
status
string
옵션
최소 : 1 , 최대 : 10
마일리지카드 상태
ACTIVE : 적립가능
TERMINATED : 적립불가 (보상완료/만료)
statusCode
string
옵션
길이 : 2
마일리지카드 상태 상세코드
01 : 활성화
02 : 마일리지 카드 완성 후 보상 완료
03 : 마일리지 카드 유효기간 만료
05 : 공카드 (적립된 마일리지 금액이 없음)
targetCount
string
옵션
최소 : 0 , 최대 : 9999999999999999999
마일리지 정책 완성 목표 금액
pageResponse
object
필수
페이징 응답 정보
page
number
필수
최소 : 0 , 최대 : 1000
현재 페에지
totalPages
number
필수
최소 : 0 , 최대 : 1000
전체 페이지 수
numberOfElements
number
필수
최소 : 0 , 최대 : 10000
전체 목록 개수
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
500
에러 코드
000_001
메시지
Unknown Reason.
설명
알 수 없는 오류
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.