docs(gift): 선물 받을 주소 요구사항을 기록한다
This commit is contained in:
@@ -384,8 +384,8 @@ Response:
|
||||
{
|
||||
"applicationNo": "A-1002609300001",
|
||||
"direction": "SENT",
|
||||
"status": "TRACKING_REGISTERED",
|
||||
"statusName": "발송 확인",
|
||||
"status": "RECEIVED",
|
||||
"statusName": "접수 완료",
|
||||
"giftInfo": {
|
||||
"recipientCreatorNickname": "크리에이터닉네임",
|
||||
"senderNickname": null,
|
||||
@@ -393,7 +393,7 @@ Response:
|
||||
"categoryName": "인형",
|
||||
"applicationNo": "A-1002609300001",
|
||||
"paidCan": 80,
|
||||
"tracking": "CJ대한통운_1234567890",
|
||||
"tracking": null,
|
||||
"shippingRequestedAt": null
|
||||
},
|
||||
"senderInfo": {
|
||||
@@ -403,11 +403,11 @@ Response:
|
||||
},
|
||||
"recipientAddress": null,
|
||||
"mailbox": {
|
||||
"name": "소다라이브 사서함",
|
||||
"address": "구현 후 제공",
|
||||
"phoneNumber": "구현 후 제공"
|
||||
"name": "소다라이브 선물 담당자",
|
||||
"address": "(06234) 서울시 강남구 ..., 3층 선물 접수처",
|
||||
"phoneNumber": "01012345678"
|
||||
},
|
||||
"trackingRequired": false,
|
||||
"trackingRequired": true,
|
||||
"recipientAddressRequired": false,
|
||||
"recipientAddressDeadlineAt": "2026-10-09T03:00:00Z",
|
||||
"delivery": {
|
||||
@@ -446,6 +446,8 @@ Response:
|
||||
}
|
||||
```
|
||||
|
||||
`mailbox`는 관리자가 등록한 전역 단일 받을 주소다. 보낸 사람 관점(`direction=SENT`)이고 상태가 운송장 등록 전인 `RECEIVED`일 때만 내려준다. 받을 주소가 등록되지 않았거나 다른 상태/방향이면 `mailbox`는 `null`이다. 주소는 상세 조회 시점의 최신 관리자 설정을 사용한다.
|
||||
|
||||
받는 크리에이터 관점 응답 예시는 다음과 같다.
|
||||
|
||||
```json
|
||||
@@ -802,6 +804,40 @@ Response:
|
||||
|
||||
크리에이터가 배송지를 아직 입력하지 않은 경우에도 `recipientInfo.nickname`은 내려주고, `recipientInfo.name`, `recipientInfo.phoneNumber`, `recipientInfo.address`는 빈 문자열 `""`로 내려준다.
|
||||
|
||||
#### 8.13.3 관리자 선물 받을 주소 설정 API
|
||||
|
||||
선물 받을 주소는 전역 단일 설정이다. 팬이 운송장을 등록하기 전에 보낸 선물 상세에서 이 주소를 확인하고 택배를 발송한다.
|
||||
|
||||
`GET /api/v2/admin/gift-mailbox`
|
||||
|
||||
Response:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "소다라이브 선물 담당자",
|
||||
"address": "(06234) 서울시 강남구 ..., 3층 선물 접수처",
|
||||
"phoneNumber": "01012345678"
|
||||
}
|
||||
```
|
||||
|
||||
설정이 없으면 공통 envelope의 `data`는 `null`이다.
|
||||
|
||||
`PUT /api/v2/admin/gift-mailbox`
|
||||
|
||||
Request:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "소다라이브 선물 담당자",
|
||||
"phoneNumber": "01012345678",
|
||||
"zipCode": "06234",
|
||||
"address": "서울시 강남구 ...",
|
||||
"addressDetail": "3층 선물 접수처"
|
||||
}
|
||||
```
|
||||
|
||||
Response는 저장된 받을 주소를 `name`, `address`, `phoneNumber`로 내려준다. `address`는 기존 주소 응답과 동일하게 `(우편번호) 주소, 상세주소` 형식이다. `name`, `phoneNumber`, `zipCode`, `address`는 필수이며 공백만 입력할 수 없다. `addressDetail`은 선택이다.
|
||||
|
||||
`availableActions`는 현재 상태별로 다음 값만 내려준다.
|
||||
|
||||
| 현재 상태 | availableActions |
|
||||
|
||||
Reference in New Issue
Block a user