docs(gift): 선물함 리스트 계약 필드를 기록한다

This commit is contained in:
2026-10-08 17:38:50 +09:00
parent 95d7568a25
commit 5d8e71df83
2 changed files with 11 additions and 1 deletions
@@ -145,6 +145,12 @@ data class GiftListItemResponse(
val priceCan: Int,
val categoryName: String,
val sizeName: String,
val counterpartMemberId: Long,
val counterpartNickname: String,
val counterpartProfileImageUrl: String,
val recipientAddressRegistered: Boolean,
val recipientAddressDeadlineAt: String?,
val canceledAt: String?,
val createdAt: String?
)
@@ -362,8 +362,9 @@ Response:
"sizeName": "소형",
"categoryName": "인형",
"priceCan": 80,
"recipientAddressRequired": false,
"recipientAddressRegistered": false,
"recipientAddressDeadlineAt": null,
"canceledAt": null,
"createdAt": "2026-09-29T03:00:00Z"
}
],
@@ -374,6 +375,9 @@ Response:
```
받은 선물은 `TRACKING_REGISTERED` 이상 상태부터 노출한다.
`recipientAddressRegistered`는 크리에이터 배송지 필수 정보가 모두 입력되었는지 여부다.
`recipientAddressDeadlineAt`은 `direction=RECEIVED`이고 배송지가 아직 입력되지 않은 경우에만 배송지 입력 기한 UTC ISO 문자열로 내려주며, 배송지 입력 완료 후에는 `null`로 내려준다.
`canceledAt`은 취소 상태의 취소일 표시용 UTC ISO 문자열이며, 취소되지 않은 선물은 `null`이다.
### 8.5 선물 상세 조회