---
title: "상품 단건 조회"
method: GET
path: "/api/v1/sales/{id}"
tags: ["상품"]
---

# 상품 단건 조회

`GET /api/v1/sales/{id}`

ID로 상품 상세 정보를 조회합니다.

## Path parameters

- `id` string, required

## Response `200`

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

- ApiResponseSaleResponse
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` SaleResponse
    - `id` string, required — 상품 ID
    - `enterpriseId` string — 기업 ID
    - `userId` string, required — 사용자 ID
    - `name` string, required — 이름
    - `translatedNames` SaleTranslatedName[], required — 다국어 이름
      - `code` string, required — 언어 코드
      - `value` string, required — 번역된 값
    - `description` SaleTranslatedName[], required — 설명
      - `code` string, required — 언어 코드
      - `value` string, required — 번역된 값
    - `tags` string[], required — 태그
    - `brandCode` string — 브랜드 코드
    - `code` string — 코드
    - `website` string — 웹사이트
    - `minPrice` SalePrice
      - `value` number, required — 가격
      - `unit` 'KRW' | 'USD' | 'EUR' | 'JPY' | 'GBP' | 'CNY' | 'VND' | 'TWD', required — 통화 단위
    - `categories` SaleCategory[], required — 카테고리 목록
      - `categoryId` string, required — 카테고리 ID
      - `order` integer, required — 순서
    - `previewImage` SaleAsset
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `images` SaleAsset[], required — 이미지 목록
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `components` SaleComponents, required
      - `optionKeys` string[], required — 옵션 키 목록
      - `records` SaleRecord[], required — 레코드 목록
        - `id` string, required — 레코드 ID
        - `order` integer, required — 순서
        - `price` SalePrice, required
          - `value` number, required — 가격
          - `unit` 'KRW' | 'USD' | 'EUR' | 'JPY' | 'GBP' | 'CNY' | 'VND' | 'TWD', required — 통화 단위
        - `options` SaleOption[], required — 옵션 목록
          - `key` string, required — 키
          - `value` string, required — 값
        - `previewImage` SaleAsset
          - `id` string, required — 에셋 ID
          - `name` string, required — 에셋 이름
          - `url` string, required — 에셋 URL
    - `createdAt` string, date-time, required — 생성일시
    - `updatedAt` string, date-time, required — 수정일시
  - `error` ErrorMessage
    - `errorCode` 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN' — 에러 코드
    - `message` string — 에러 메시지

---

[API](https://skmtc.dev/archisketch/apis/open-api.md) · [All operations](https://skmtc.dev/archisketch/apis/open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archisketch/open-api/revisions/f6b0eda1a99d/schema)