시술 메뉴판 개발하기
이번 페이지에서는 상품, 이벤트 메뉴를 외부 채널에서 구성하기 위해 필요한 지식들을 설명합니다.
상품 구조 소개
상품 구성 요소
상품 페이지를 구성하기 위해 제공되는 데이터는 다음 세 가지 주요 요소로 이루어져 있습니다.
-
상품 카테고리 (Category)
상품을 분류하기 위한 최상위 개념입니다.
-
상품 (Product)
병원이 내원객에게 제공하는 시술 품목을 의미합니다. 상품은 시술의 옵션들로 구성됩니다.
-
옵션 (Option)
각 상품에 대해 선택할 수 있는 구체적인 가격, 시술, 단위 등이 포함되어있는 값입니다.
상품, 카테고리, 옵션의 관계
이 세 가지 요소는 계층적인 관계를 가집니다.
- 하나의 카테고리는 여러 개의 상품을 포함합니다.
- 하나의 상품은 여러 개의 옵션을 가질 수 있습니다.
(예시)
- 카테고리: "보톡스"
- 상품: "이마 보톡스"
- 옵션: "이마 보톡스 1회", "이마 보톡스 + 아쿠아필 패키지"
- 상품: "사각턱 보톡스"
- 옵션: "사각턱 보톡스 1회", "사각턱 보톡스 3회 패키지"
- 상품: "이마 보톡스"
상품 API 설명
KOS API를 사용하여 상품 페이지를 구성할 때는 다음의 절차를 따를 수 있습니다.
-
카테고리 조회
상품 카테고리 목록 조회 API를 호출하여 카테고리 데이터를 가져옵니다. 이 데이터는 외부 채널의 상품 목록을 그룹화하는 데 사용됩니다.
-
카테고리에 해당하는 상품 목록 조회
특정 카테고리에 속한 상품 데이터를 상품 목록 조회를 통해 가져옵니다. 각 상품의 이름, 카테고리, 설명, 이미지, 옵션 등이 포함됩니다.
-
상품 단건 조회
특정 단건 상품에 대한 데이터가 필요하다면 상품 단건 조회 API를 호출하여 사용자가 구체적으로 원하는 상품 구성을 보여줄 수 있습니다.
데이터 조합
위에서 조회한 데이터를 조합하여 다음과 같은 형태로 페이지를 구성할 수 있습니다.
- 카테고리를 헤더로 나열
- 각 카테고리에 속한 상품을 카드 형식으로 표시
- 상품 카드에 옵션을 선택할 수 있는 UI 제공
- 상품 옵션을 선택하여 장바구니 기능 제공
- 옵션 기반 예약 가능 시간대 조회
상품 검색
KOS는 상품 옵션 검색 API를 지원하고있습니다.
e.g.
{
"searchText": "보톡스", // 검색어
"targetCountryCode": "KR" // 타겟 국가 (KR, ETC, ...)
}
요청 시 "사각턱 보톡스", "이마 보톡스", "보톡스 주사"와 같이 옵션명에 보톡스가 포함된 시술 데이터 목록을 반환합니다.