상품 관리
관리자 권한으로 상품을 조회 · 등록 · 수정 · 삭제합니다. 쇼핑몰 관리자 > 상품 관리 · 상품 등록과 같은 검증 · 같은 기록입니다.
업데이트됨 10.19 — 상품 복사가 생겼습니다무엇인가요
쇼핑몰 소유자를 대신하는 토큰으로 이 쇼핑몰의 상품과 상품 카테고리를 다룹니다. 쇼핑몰 관리자 > 상품 관리 · 상품 등록 · 상품 카테고리와 같은 검증 · 같은 기록입니다 — 바꾼 것은 상품 기록에 사람과 앱이 함께 남습니다.
| 요청 | 경로 | 내용 | 권한 |
|---|---|---|---|
| GET | /products | 상품 목록 | products:read |
| GET | /products/{product_unique} | 상품 상세 | products:read |
| POST | /products | 상품 등록 | products:write |
| PATCH | /products/{product_unique} | 상품 수정 | products:write |
| DELETE | /products/{product_unique} | 상품 삭제 | products:write |
| POST | /products/{product_unique}/copy | 상품 복사 | products:write |
| POST | /products/bulk | 상품 일괄 처리 | products:write |
| GET | /categories 외 생성 · 수정 · 옮기기 · 삭제 | 상품 카테고리 | products:read · write |
| GET | /badges 외 생성 · 수정 · 삭제 | 상품 배지 | products:read · write |
| GET | /icons 외 생성 · 수정 · 삭제 | 상품 아이콘 | products:read · write |
같이 쓰는 규칙
- 필드 이름은 snake_case 입니다(
sale_price·stock_quantity…). 상세 응답에 나온 키를 그대로 보내면 됩니다. - 원가(
cost_price)는 상세에만 나옵니다. 목록에는 없습니다. - 수정은 보낸 필드만 바뀝니다.
expected_updated로 그 사이 다른 사람이 고쳤을 때 덮어쓰지 않게 막습니다. - 상품에 거는 카테고리 · 템플릿 키는 상품 카테고리 · 상품 배지 · 상품 아이콘 · 템플릿 관리에서 얻습니다.
- 손님 화면에 보이는 그대로(등급가 · 노출 규칙)가 필요하면 회원 API 의 상품 목록을 쓰세요.