우편의 종류
우편 종류
| 구분 | 설명 |
|---|---|
| 관리자 우편 | 뒤끝 콘솔에서 발송하는 관리자 우편 |
| 쿠폰 우편 | 뒤끝 콘솔의 웹 쿠폰 설정에서 생성한 페이지로 쿠폰을 사용 후 발송되는 쿠폰 우편 |
| 랭킹 보상 우편 | 랭킹 보상 후 자동으로 지급되는 랭킹 우편 |
| 웹숍 우편 | 웹숍에서 아이템 구매 후 발송되는 우편 (뉴플레이에서는 인증 번호 발송 우편도 포함) |
| 유저 우편 | 유저 간 게임 정보 관리의 데이터를 이용해 발송한 유저 우편 |
우편 만료일
| 구분 | 만료일 |
|---|---|
| 관리자 우편 | 콘솔에서 설정한 시간(하루 이내 - 1시간, 3시간, 6시간, 12시간, 24시간, 7일, 15일, 30일) |
| 쿠폰 우편 | 쿠폰 수령 후 우편 발송 시 제한없음(쿠폰이 만료될 경우 우편 발송이 되지 않습니다.) |
| 랭킹 보상 우편 | 7일 |
| 웹숍 우편 | 30일 |
| 유저 우편 | 15일 |
우편 삭제 시점
| 구분 | 삭제 시점 |
|---|---|
| 관리자 우편 | 유저가 우편 수령 시 |
| 쿠폰 우편 | 유저가 우편 수령 시 |
| 랭킹 보상 우편 | 유저가 우편 수령 시 |
| 웹숍 우편 | 유저가 우편 수령 시 |
| 유저 우편 | 우편 삭제 함수 호출 시(재수령 불가) |
우편 불러오기 리턴값
모든 우편에는 우편에 공통적으로 들어가는 제목(title)과 유니크값(inDate)를 제외하고 리턴값에 차이점이 존재합니다.
따라서 우편별로 지원되는 리턴값에 맞게 파싱하는 로직을 구성하여야 예외 상황이 발생하지 않습니다.
공통 리턴값 존재 여부
| 관리자 우편 | 랭킹 우편 | 쿠폰 우편 | 웹숍 우편 | |
|---|---|---|---|---|
| title | O | O | O | O |
| inDate | O | O | O | O |
| rankType | O | |||
| author | O | O | ||
| content | O | O | O | |
| expirationDate | O | O | O | |
| reservationDate | O | O | ||
| sentDate | O | O | ||
| nickname | O | O | ||
| items | O | O | O |
관리자 우편
| 리턴값 | 설명 |
|---|---|
| title | 우편의 제목 |
| inDate | 우편의 유니크값 |
| content | 우편의 내용 |
| author | 우편의 발송인 |
| expirationDate | 만료 기간 |
| reservationDate | 발송 기간 |
| sentDate | 발송 기간 |
| nickname | 수신인의 닉네임(없을 경우에는 null로 표시됩니다.) |
| items | 우편에 첨부된 아이템에 대한 배열 |
items는 배열 형태로 되어있으며 각각 item, itemCount, chartName값이 들어가있습니다. item은 우편 발송 시 첨부된 차트에 대한 정보입니다.
랭킹 보상 우편
| 리턴값 | 설명 |
|---|---|
| title | 우편의 제목 |
| inDate | 우편의 유니크값 |
| rankType | 랭킹의 종류 |
| content | 우편의 내용 |
| expirationDate | 만료 기간 |
| reservationDate | 발송 기간 |
| sentDate | 발송 기간 |
| nickname | 수신인의 닉네임(없을 경우에는 null로 표시됩니다.) |
| items | 우편에 첨부된 아이템에 대한 배열 |
items는 배열 형태로 되어있으며 각각 item, itemCount, chartName값이 들어가있습니다. item은 우편 발송 시 첨부된 차트에 대한 정보입니다.
쿠폰 우편
| 리턴값 | 설명 |
|---|---|
| title | 쿠폰의 제목 |
| inDate | 우편의 유니크값 |
| items | 우편에 첨부된 아이템에 대한 배열 |
items는 배열 형태로 되어있으며 각각 item, itemCount, chartName값이 들어가있습니다. item은 우편 발송 시 첨부된 차트에 대한 정보입니다.
웹숍 우편
| 리턴값 | 설명 |
|---|---|
| title | 우편의 제목 |
| inDate | 우편의 유니크값 |
| content | 우편의 내용 |
| expirationDate | 만료 기간 |
| webshop | 우편이 발송된 웹숍 서비스 이름 |
| author | 우편의 발송인 |
| buyer | 우편의 구매자 |
| orderId | 우편의 주문 번호 |
| itemId | 우편의 아이템 ID |
| item | 우편에 첨부된 아이템에 대한 객체 |
5.18.6 이전 SDK 버전 호환성
5.18.6 이전 버전 SDK에서는 웹숍 우편 처리를 하기 위해서는 아래의 함수를 이용하여 우편 처리를 해야 합니다.
// 웹숍 우편 리스트 불러오기
// 우편 타입을 5로 지정해야 웹숍 우편을 불러올 수 있습니다.
// 기존 함수 인 GetPostList와 동일한 기능을 수행합니다.
var bro = Backend.NewFunctions.Mail.GetMailList((MailType)5);
// 웹숍 우편 수령 하기
// 우편 타입을 5로 지정해야 웹숍 우편을 수령할 수 있습니다.
// 기존 함수 인 ReceivePostItem과 동일한 기능을 수행합니다.
var bro = Backend.NewFunctions.Mail.ReadMail((MailType)5, "2026-01-27T06:57:16.078Z");
// 웹숍 우편 모두 수령 하기
// 우편 타입을 5로 지정해야 웹숍 우편을 모두 수령할 수 있습니다.
// 기존 함수 인 ReceivePostItemAll과 동일한 기능을 수행합니다.
var bro = Backend.NewFunctions.Mail.ReadAllMail((MailType)5);
유저 우편
| 리턴값 | 설명 |
|---|---|
| title | 우편의 제목 |
| inDate | 우편의 유니크값 |
| content | 우편의 내용 |
| expirationDate | 만료 날짜 |
| sentDate | 보낸 날짜 |
| receiverInDate | 받은 유저의 inDate |
| receiverNickname | 받은 유저의 닉네임 |
| senderInDate | 보낸 사람의 inDate |
| senderNickname | 보낸 사람의 닉네임 |
| sender | 보낸 사람의 회원 번호 |
| receivedDate | 우편을 수령한 날짜(수령하지 않았을 경우에는 존재하지 않습니다 |
| item | 보낸 아이템 정보(타 우편과는 다르게 단수형입니다) |
| itemLocation | 아이템이 위치한 테이블과 컬럼 |