상품 등록
기존에 운영 중이던 상품 정보를 등록하는 API입니다.
이전 시스템에서 관리하던 상품 데이터를 손쉽게 이전할 수 있으며, 외부 채널(예: 오프라인 매장, 제휴몰 등)을 통해 확보된 상품도 본 API를 통해 등록함으로써 상품 데이터를 일관성 있게 통합 관리할 수 있습니다.
POST
https://api.bootapi.com/v1/products
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
상품 등록 요청
상품 정보를 담아 API를 호출합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 필수 | 상품명 |
desc | string | 상품 요약 설명 | |
content | string | 상품 상세 설명 (HTML 지원) | |
images | array | 상품 이미지 URL 배열 (첫 번째가 대표 이미지) | |
category_id | string | 카테고리 ID | |
display_price | number | 필수 | 판매가 (표시가) |
tax_free_price | number | 비과세 가격 | |
use_stock | boolean | 재고 관리 사용 여부 | |
stock | integer | 재고 수량 | |
use_subscription | boolean | 구독 상품 여부 | |
subscription_setting_id | string | 구독 설정 템플릿 ID | |
use_discount | boolean | 할인 사용 여부 | |
discount_price | number | 할인가 | |
status_display | boolean | 쇼핑몰 노출 여부 | |
status_sale | boolean | 판매 상태 | |
ex_uid | string | 외부 시스템 고유 ID |
3
Server
응답 처리
생성된 상품의 ID가 반환됩니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
product_id | string | 생성된 상품의 고유 ID |
에러 코드
PRODUCT_OPTION_LENGTH_INVALID
상품 옵션의 키와 이름 개수가 일치하지 않습니다.
옵션의 keys와 name 배열의 개수를 동일하게 맞춰주세요.
EX_UID_DUPLICATED
이미 존재하는 ex_uid를 가진 데이터가 있습니다.
다른 ex_uid를 사용하세요.
