API 문서
전체 API
서비스
받은 카드/쿠폰 선물 목록 조회동기
버전: v1
버전: v1
/api/v1/gifts/cards/inbox
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
giftData
array of objects
필수
선물 목록
giftData_item
object
옵션
transferId
string
필수
길이 : 20
카드 선물 ID
giftType
string
필수
최소 : 1 , 최대 : 6
선물 타입
- CARD
- COUPON
gift type.
- CARD
- COUPON
par
string
조건부
길이 : 27
선물 유형이 CARD인 경우에만 유효
- 받는 사람이 선물을 받기 전에 "SendPar"
- 받는 사람이 선물을 수락한 후에는 "ReceiverPar"
couponNo
string
조건부
길이 : 16
쿠폰번호 (선물형이 쿠폰인 경우에만 유효)
coupon no. (only valid if gift type is COUPON)
serviceId
string
필수
길이 : 15
선물형이 CARD이면 서비스 ID
선물형이 쿠폰이면 쿠폰 ID
amount
string
조건부
최소 : 1 , 최대 : 9999999999
금액. (giftType이 CARD인 경우에만 유효)
senderUserId
string
필수
최소 : 1 , 최대 : 9999999999999999999
쿠폰 전송하는 사용자ID
senderPhone
string
필수
최소 : 1 , 최대 : 20
발송인 휴대폰번호
receiverUserId
string
필수
최소 : 1 , 최대 : 9999999999999999999
수신자 ID
Receiver Id
receiverPhone
string
필수
최소 : 1 , 최대 : 20
수신자 휴대폰번호
sentDateTime
string
필수
길이 : 14
선물 전송 시간
settlementDateTime
string
옵션
길이 : 14
선물 완료일
canceledDateTime
string
옵션
길이 : 14
선물 취소 시간
expiryDate
string
필수
길이 : 14
선물 만료일
cardExpiryDate
string
옵션
길이 : 6
카드유효기간
- yyMMdd
status
string
필수
길이 : 2
선물 상태
- "00" : Ready (수신자 측 상태로 발송인이 보낸 선물을 수신자가 받지 않은 상태)
- "01" : 송신(발송인 측 상태로 발송인이 보낸 선물을 수신자가 받지 않은 상태)
- "02" : 수락(수신자가 선물을 성공적으로 수락)
- "03" : 거절당하였습니다(수신자가 선물 수신을 거절)
- "04" : 철회(발신자에 의해 선물이 취소 됨)
- "05" : 복구됨 (선물이 만료 되어 발신자에게 되돌아감)
- "06" : 발급(수신자가 카드선물을 수락 하여 발신 잔액을 수신하기 위한 카드가 발급 됨)
- "07" : 차감(수신자가 카드선물을 수락 하여 발신자가 선물한 카드 잔액이 차감 됨)
- "08" : 입금(발신잔액을 수신하기위한 카드에 발신자가 선물한 카드의 잔액이 입금 됨)
- "09" : 실패
- "10" : 기프트 카드에 해당하는 서비스가 만료, 삭제 또는 중지 됨
reservedMsgOne
string
필수
최소 : 1 , 최대 : 255
선물 메세지 1
reservedMsgTwo
string
필수
최소 : 1 , 최대 : 255
선물 메세지 2
serviceImageUrl
string
옵션
최소 : 1 , 최대 : 255
서비스 이미지 URL
serviceThumbnailImageUrl
string
옵션
최소 : 1 , 최대 : 255
서비스 썸네일 이미지 URL
serviceName
string
필수
최소 : 1 , 최대 : 255
상품 명
senderName
string
옵션
최소 : 1 , 최대 : 255
발신자명
senderRealName
string
옵션
최소 : 1 , 최대 : 255
발신자 실명
receiverRealName
string
옵션
최소 : 1 , 최대 : 255
수신자 명
receiverName
string
옵션
최소 : 1 , 최대 : 255
수신자 실명
pageResponse
object
필수
페이징 응답 정보
page
number
필수
값 : 1000
페이징 인덱스
- 기본값 = 0
totalPages
number
필수
값 : 1000
전체 페이지 수
numberOfElements
number
필수
값 : 10000
전체 목록 개수
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.