특정 카테고리 id(category_id)로 최하위(leaf) 카테고리를 조회합니다.
category_id 파라미터가 없는 경우 조회가 되지 않습니다.
조회시점에 존재하지 않거나 사용불가한 카테고리의 경우에는 category_not_found error 가 발생합니다.
요청
GET /v1/gift/products/categories/search?id={id}<요청 파라미터 설명>
| 필드명 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| id | Long | 필수 | 특정 카테고리ID 로 카테고리 세부정보를 확인할 수 있습니다. 최하위(leaf) 카테고리ID를 입력해주세요. |
응답
요청이 성공하면, 응답 바디에 카테고리가 조회됩니다.
최하위(leaf) 카테고리ID를 기준으로 조회/응답됩니다.
<응답 바디>
CategoryResponse
| 필드명 | 타입 | 설명 |
|---|---|---|
| id | Long | 카테고리ID |
| name | String | 카테고리명 |
| lastLevel | boolean | 리프 카테고리인 경우 true |
| pathName | String | 전체 카테고리명 |
| advertisementReviewRequirement | String | 광고심의서류 등록 필수/선택 여부 (해당 없을시 키 자체 생략) - REVIEW_REQUIRED (필수) - REVIEW_SELECTED (선택) |
| advertisementReviewTypes | Array[String] | 광고심의서류 유형 코드 목록 - MEDICAL_EQUIP_REVIEW (의료기기) - HEALTH_FOOD_REVIEW (건강기능식품) - ETC_REVIEW (기타) |
| certTypes | Array[String] | 인증 유형 코드 목록 - CERT_KC_REQUIRED (KC 인증 필수) - CERT_KC_OPTIONAL (KC 인증 노출) - CERT_FOOD (식품 인증 노출) - CERT_ECOLIFE (생활화학/살생물제품 인증) - CERT_GREEN (비건인증) |
| authorityTypes | Array[String] | 판매자 권한 필요 유형 코드 목록 - LIQUOR (전통주) - HEALTH_FOOD (건강기능식품) - MEDICAL_EQUIP (의료기기) - TRAVEL_LEISURE (여행레저) - PICKUP (매장픽업) |
| etcTypes | Array[String] | 그 외 카테고리 속성 코드 목록 * 위 속성들은 필요에따라 추가될 수 있습니다 |
<응답 바디 샘플>
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
// 광고심의 필수 + 건기식 권한 + 식품인증
{
"id": "102105102100",
"name": "홍삼액/홍삼정",
"lastLevel": true,
"pathName": "홍삼/건강/다이어트식품>홍삼/인삼>홍삼액/홍삼정",
"advertisementReviewRequirement": "REVIEW_REQUIRED",
"advertisementReviewTypes": ["HEALTH_FOOD_REVIEW"],
"certTypes": ["CERT_FOOD"],
"authorityTypes": ["HEALTH_FOOD"],
"etcTypes": []
}
// 광고심의 해당 없음 -> advertisementReviewRequirement 필드 생략, KC 인증만
{
"id": "100101102",
"name": "모니터",
"lastLevel": true,
"pathName": "데스크탑/모니터/PC부품>모니터",
"advertisementReviewTypes": [],
"certTypes": ["CERT_KC_REQUIRED"],
"authorityTypes": [],
"etcTypes": []
}