템플릿 관리
상품 > 템플릿 관리 — 상품을 등록할 때 고르는 안내 · 배송 · 옵션 · 리뷰 틀을 관리합니다. 관리자 퀵메뉴와 같은 묶음입니다.
무엇인가요
쇼핑몰 관리자 > 상품 > 템플릿 관리의 퀵메뉴와 같은 작업을 엽니다. 상품을 등록할 때 고르는 안내 · 배송 · 옵션 · 리뷰 틀입니다. 외부 서비스가 관리자 화면 없이 같은 일을 할 수 있습니다. 읽기는 products:read, 쓰기는 products:write 입니다.
| 메뉴 | 경로 | 상품에서 쓰는 곳 |
|---|---|---|
| 공통정보 | /templates/common | top_template_ids · bottom_template_ids |
| 택배배송 | /templates/delivery?method=PARCEL | delivery[].template_id |
| 직접배송 | /templates/delivery?method=DIRECT | delivery[].template_id |
| 퀵배송 | /templates/delivery?method=QUICK | delivery[].template_id |
| 방문수령 | /templates/delivery?method=PICKUP | delivery[].template_id |
| 색상 | /templates/colors | color_ids · 옵션 color_hex |
| 사이즈 | /templates/sizes | size_template_id · sizes |
| 맞춤형 리뷰 | /templates/reviews | review_template_id |
| 배송 할증지역 | /surcharges | 주문 배송비(제주 · 도서산간) |
같이 쓰는 요청 규칙
배송 할증지역을 뺀 템플릿은 모두 같은 다섯 요청을 씁니다. {kind} 는 common · delivery · colors · sizes · reviews 입니다.
| 요청 | 내용 |
|---|---|
GET /templates/{kind} | 목록 {items}. 줄마다 used_count(이 템플릿을 쓰는 상품 수 — 관리자 목록의 적용상품)가 붙습니다 |
POST /templates/{kind} | 생성 → 201 과 새 키 |
GET /templates/{kind}/{id} | 상세 |
PATCH /templates/{kind}/{id} | 보낸 필드만 바뀝니다 — 바꿀 칸만 보내세요 |
DELETE /templates/{kind}/{id} | 지웁니다. 쓰던 상품에서는 떼어지고 몇 건이 바뀌었는지(affected · released) 돌려줍니다 |
생성할 때 가장 쉬운 방법
필드가 많은 템플릿(배송 등)은 기존 템플릿을 읽어(
GET) 키(template_unique)를 빼고 이름만 바꿔 POST 하면 같은 설정으로 하나가 더 생깁니다.