API 문서
전체 API
서비스
카드 선물 내역 조회 (관리자용)동기
버전: v1
버전: v1
/api/v1/admin/gifts/cards/list
요청 헤더
요청 파라미터
응답 헤더
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
senderUserId
number
필수
최소 : 1 , 최대 : 9999999999999999999
발송인 회원 ID
senderPhone
string
필수
최소 : 1 , 최대 : 20
발송인 휴대폰 번호
receiverUserId
number
필수
최소 : 1 , 최대 : 9999999999999999999
수신자 회원 ID
receiverPhone
string
필수
최소 : 1 , 최대 : 20
수신자 휴대폰 번호
sentDateTime
string
필수
길이 : 14
선물 전송 시간
- format : yyyyMMddHHmmss
status
string
필수
길이 : 2
선물 상태
- "00" : Ready (수신자 측 상태로 발송인이 보낸 선물을 수신자가 받지 않은 상태)
- "01" : 송신(발송인 측 상태로 발송인이 보낸 선물을 수신자가 받지 않은 상태)
- "02" : 수락(수신자가 선물을 성공적으로 수락)
- "03" : 거절당하였습니다(수신자가 선물 수신을 거절)
- "04" : 철회(발신자에 의해 선물이 취소 됨)
- "05" : 복구됨 (선물이 만료 되어 발신자에게 되돌아감)
- "06" : 발급(수신자가 카드선물을 수락 하여 발신 잔액을 수신하기 위한 카드가 발급 됨)
- "07" : 차감(수신자가 카드선물을 수락 하여 발신자가 선물한 카드 잔액이 차감 됨)
- "08" : 입금(발신잔액을 수신하기위한 카드에 발신자가 선물한 카드의 잔액이 입금 됨)
- "09" : 실패
- "10" : 기프트 카드에 해당하는 서비스가 만료, 삭제 또는 중지 됨
pageResponse
object
필수
페이징 응답 정보
page
number
필수
최소 : 0 , 최대 : 1000
페이징 인덱스
- 기본값 = 0
totalPages
number
필수
최소 : 0 , 최대 : 1000
전체 페이지 수
numberOfElements
number
필수
최소 : 0 , 최대 : 10000
전체 목록 개수
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success
설명
성공
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.
