상품 등록

기존에 운영 중이던 상품 정보를 등록하는 API입니다.

이전 시스템에서 관리하던 상품 데이터를 손쉽게 이전할 수 있으며, 외부 채널(예: 오프라인 매장, 제휴몰 등)을 통해 확보된 상품도 본 API를 통해 등록함으로써 상품 데이터를 일관성 있게 통합 관리할 수 있습니다.

POST

https://api.bootapi.com/v1/products

Server

SDK 설치

서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.

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

Server

응답 처리

생성된 상품의 ID가 반환됩니다.

응답 필드

필드명

타입

설명

product_id

string

생성된 상품의 고유 ID

에러 코드

PRODUCT_OPTION_LENGTH_INVALID

상품 옵션의 키와 이름 개수가 일치하지 않습니다.

옵션의 keys와 name 배열의 개수를 동일하게 맞춰주세요.

EX_UID_DUPLICATED

이미 존재하는 ex_uid를 가진 데이터가 있습니다.

다른 ex_uid를 사용하세요.

언어