상품정보를 조회 할 때 사용합니다. 상품번호 또는 판매자 상품코드 기준으로 조회 할 수 있습니다.
요청
GET /v1/gift/products/search?id={id}
<요청 파라미터 설명>
필드명 | 타입 | 필수여부 | 설명 |
id | Long | 필수 | 상품 ID |
sellerManagementCode | String | 필수 | 판매자 상품코드 |
응답
조회 성공시에는 응답 바디에 상품정보가 포함되나
상품번호에 매칭되는 상품이 없는 경우 빈 contents가 조회 됩니다.
<응답 바디>
필드명 | 타입 | 설명 |
id | Long | 상품 ID |
saleStatus | SaleStatus | 판매상태 |
prohibitionDetail | ProhibitionDetailView | 판매금지 상세정보 |
categoryId | String | 카테고리 ID |
categorySupplements | List<ProductCategorySupplementView> | 카테고리 부가 정보 |
advertisementReviews | List<AdvertisementReview> | 광고심의서류 파일 uuid |
bundleQuantity | Integer | 번들수량 |
name | String | 상품명 |
image | ProductImageView | 상품 이미지 정보 |
originArea | ProductOriginAreaView | 원산지 정보 |
giftBrandId | Long | 브랜드 ID |
model | ProductModelView | 모델 |
manufacturer | String | 제조사 |
sellerManagementCode | String | 판매자 관리코드 |
salePeriod | SalePeriodView | 판매 기간 |
booked | BookedView | 예약 판매 설정 |
productAdditionalInfo | ProductAdditionalInfo |
상품 부가정보 (선물포장 여부, 커스텀 제작상품 여부) |
suggestionName | String | 선물제안명 |
taxType | TaxType | 부가세 타입 |
salePrice | BigDecimal | 판매가 |
discount | DiscountView | 즉시할인 정보 |
detailDescription | String | 상품상세 |
announcementInfo | AnnouncementInfoView | 상품 정보 고시 |
certs | List<CertView> | 상품 인증 정보 |
minorPurchasable | boolean | 미성년자 구매가능 여부 |
purchaseQuantity | PurchaseQuantityView | 구매수량 제한 |
option | OptionView | 옵션 정보 |
optionChangeable | boolean | 옵션변경가능여부 |
stock | 재고 수량 | |
delivery | DeliveryView | 배송 정보 |
displayStatus | DisplayStatus | 전시 여부 |
shoppingHowDisplayable | boolean | 쇼핑하우전시여부 |
mdMessage | String | MD전달사항 |
modificationReason | String | 수정사유 |
<응답 바디 샘플>
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"contents": [
{
"id": 100000,
"categoryId": "101102109120",
"categorySupplements": [],
"name": "상품명",
"image": {
"imageRatio": "SQUARE",
"representImage": {
"url": "https://st.kakaocdn.net/product/gift/image.png"
}
},
"originArea": {
"originAreaType": "LOCAL",
"originAreaContent": "국내산",
"originAreaCode": "00",
"registerWithOtherOriginArea": false
},
"giftBrandId": 00000,
"manufacturer": "제조사",
"sellerManagementCode": "판매자상품코드",
"salePeriod": {
"useSalePeriod": "true",
"salePeriod": {
"from": "20200801000000",
"to": "20291231235959"
}
},
"booked": {
"booked": "true",
"bookedDate": "20200802000000"
},
"taxType": "TAX",
"salePrice": 10000,
"detailDescription": "<html>\n <head></head>\n <body>\n <p>\n <!-- Not Allowed Attribute Filtered ( data-animated=\"false\") --><img src=\"https://st.kakaocdn.net/product/gift/image.png" data-animated=\"false\"></p>\n </body>\n</html>",
"announcementInfo": {
"announcementType": "WEAR",
"announcement": {
"announcementType": "WEAR",
"ignoreAll": true,
"ignoreKeys": [
"manufacturedDate",
"material",
"color",
"size",
"afterServiceDirector",
"warrantyPolicy",
"caution",
"manufacturer"
]
}
},
"certs": [],
"minorPurchasable": true,
"option": {
"type": "NONE",
"simples": [],
"combinations": [],
"customs": []
},
"stock": {
"unlimitedStockQuantity": false,
"stockQuantity": 1000
},
"delivery": {
"deliveryMethodType": "DELIVERY",
"bundleGroupAvailable": true,
"deliveryFeeType": "FREE",
"baseFee": 0,
"deliveryFeePaymentType": "PREPAID",
"shippingAddressId": 00000,
"returnAddressId": 00000,
"returnDeliveryFee": 3000,
"exchangeDeliveryFee": 6000,
"asPhoneNumber": "031-000-0000",
"asGuideWords": "",
"isIsolatedAreaDeliverable": true
},
"displayStatus": "OPEN",
"shoppingHowDisplayable": true,
"advertisementReviews": [{
"sellerFileUuid": "d3145fe9-0188-1000-0000-02d7a90b7a9f"
}, {
"sellerFileUuid": "f592908c-9999-1000-0000-727712557596"
}],
"prohibitionDetail": {
"prohibitionModifiedAt": "20230101000000",
"reasonType": "PRMS",
"violationReason": "위반사유",
"detailReason": "상세사유"
}
}
],
"totalCount": 1,
"last": true
}