---
title: "템플릿 ID로 상품 제약 템플릿 상세 조회"
method: GET
path: "/api/v3/shopping-fep/product-constraint-templates/{templateId}"
tags: ["상품 Public Controller"]
---

# 템플릿 ID로 상품 제약 템플릿 상세 조회

`GET /api/v3/shopping-fep/product-constraint-templates/{templateId}`

템플릿 ID를 이용하여 상품 제약 조건 템플릿의 판매 옵션 상세 정보를 조회합니다.

## 판매 옵션 구조

판매 옵션은 두 가지로 분류됩니다.

- **selectOneSaleOptions (택1 그룹)**: `groupKey`로 묶인 옵션 그룹입니다. 같은 그룹 내에서 하나만 선택해야 합니다.
- **salesOptions (일반 옵션)**: 개별 판매 옵션입니다.

## Path parameters

- `templateId` integer, required

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- object
  - `resultType` 'SUCCESS' | 'FAIL' — 응답 결과 타입
  - `error` object — 에러 응답, resultType FAIL 시 제공
    - `errorCode` 'COMMON_ERROR' — 에러 코드
    - `reason` string — 에러 사유
  - `success` GetProductConstraintTemplateByIdFepResponse — 템플릿 ID 기반 상품 제약 조건 템플릿 상세 응답
    - `selectOneSaleOptions` SelectOneSaleOptionFepResponse[], required — 택1 판매 옵션 그룹 목록
      - `groupKey` string, required — 그룹 키
      - `options` SalesOptionFepResponse[], required — 그룹 내 판매 옵션 목록
        - `id` integer, required — 판매 옵션 ID
        - `key` string, required — 옵션 키
        - `optionValueTemplate` OptionValueTemplateFepResponse, required — 옵션 값 템플릿
          - `optionGroupId` integer, required — 옵션 그룹 ID
          - `optionGroupName` string, required — 옵션 그룹 명
          - `formatType` string, required — 입력 포맷 타입 (TEXT: 자유 입력, NUMBER: 숫자 입력 + 단위, DROPDOWN: 선택형 입력, RANGE: 숫자 구간 + 단위)
          - `valueCandidates` string[], required — 입력 가능한 값 리스트
          - `isOption` boolean, required — 옵션 여부 (true: 선택 항목, false: 필수 항목)
          - `placeholder` string — 입력 예시
          - `unitValues` string[] — 입력 단위
          - `keyComment` string — 옵션 키에 대한 추가 설명
          - `valueComment` string — 옵션 값에 대한 추가 설명
        - `isOneOfRequiredGroup` boolean, required — 택1 필수 그룹 여부
    - `salesOptions` SalesOptionFepResponse[], required — 판매 옵션 목록
      - `id` integer, required — 판매 옵션 ID
      - `key` string, required — 옵션 키
      - `optionValueTemplate` OptionValueTemplateFepResponse, required — 옵션 값 템플릿
        - `optionGroupId` integer, required — 옵션 그룹 ID
        - `optionGroupName` string, required — 옵션 그룹 명
        - `formatType` string, required — 입력 포맷 타입 (TEXT: 자유 입력, NUMBER: 숫자 입력 + 단위, DROPDOWN: 선택형 입력, RANGE: 숫자 구간 + 단위)
        - `valueCandidates` string[], required — 입력 가능한 값 리스트
        - `isOption` boolean, required — 옵션 여부 (true: 선택 항목, false: 필수 항목)
        - `placeholder` string — 입력 예시
        - `unitValues` string[] — 입력 단위
        - `keyComment` string — 옵션 키에 대한 추가 설명
        - `valueComment` string — 옵션 값에 대한 추가 설명
      - `isOneOfRequiredGroup` boolean, required — 택1 필수 그룹 여부

---

[API](https://skmtc.net/toss/apis/shoppingfep-api.md) · [All operations](https://skmtc.net/toss/apis/shoppingfep-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/toss/shoppingfep-api/revisions/57a25c0addc6/schema)