# 상품

## 상품 단건 조회

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

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"ApiResponseSaleResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/SaleResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"SaleResponse":{"type":"object","properties":{"id":{"type":"string","description":"상품 ID"},"enterpriseId":{"type":"string","description":"기업 ID"},"userId":{"type":"string","description":"사용자 ID"},"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"},"minPrice":{"$ref":"#/components/schemas/SalePrice","description":"최소 가격"},"categories":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SaleCategory"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"},"images":{"type":"array","description":"이미지 목록","items":{"$ref":"#/components/schemas/SaleAsset"}},"components":{"$ref":"#/components/schemas/SaleComponents","description":"구성품"},"createdAt":{"type":"string","format":"date-time","description":"생성일시"},"updatedAt":{"type":"string","format":"date-time","description":"수정일시"}},"required":["categories","components","createdAt","description","id","images","name","tags","translatedNames","updatedAt","userId"]},"SaleTranslatedName":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SalePrice":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"SaleCategory":{"type":"object","properties":{"categoryId":{"type":"string","description":"카테고리 ID"},"order":{"type":"integer","format":"int32","description":"순서"}},"required":["categoryId","order"]},"SaleAsset":{"type":"object","properties":{"id":{"type":"string","description":"에셋 ID"},"name":{"type":"string","description":"에셋 이름"},"url":{"type":"string","description":"에셋 URL"}},"required":["id","name","url"]},"SaleComponents":{"type":"object","properties":{"optionKeys":{"type":"array","description":"옵션 키 목록","items":{"type":"string"}},"records":{"type":"array","description":"레코드 목록","items":{"$ref":"#/components/schemas/SaleRecord"}}},"required":["optionKeys","records"]},"SaleRecord":{"type":"object","properties":{"id":{"type":"string","description":"레코드 ID"},"order":{"type":"integer","format":"int32","description":"순서"},"price":{"$ref":"#/components/schemas/SalePrice","description":"가격"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOption"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"}},"required":["id","options","order","price"]},"SaleOption":{"type":"object","properties":{"key":{"type":"string","description":"키"},"value":{"type":"string","description":"값"}},"required":["key","value"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}":{"get":{"tags":["상품"],"summary":"상품 단건 조회","description":"ID로 상품 상세 정보를 조회합니다.","operationId":"getSale","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseSaleResponse"}}}}}}}}}
```

## 상품 전체 수정

> 상품을 전체 수정합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleCreateRequest":{"type":"object","properties":{"info":{"$ref":"#/components/schemas/SaleInfoRequest","description":"상품 정보"},"previewImage":{"type":"string","description":"대표 이미지 ID"},"images":{"type":"array","description":"이미지 ID 목록","items":{"type":"string"}},"category":{"$ref":"#/components/schemas/SaleCategoryRequest","description":"카테고리"},"components":{"$ref":"#/components/schemas/SaleComponentsRequest","description":"구성품"},"isPersonal":{"type":"boolean","description":"개인 여부"}},"required":["images","info","isPersonal"]},"SaleInfoRequest":{"type":"object","properties":{"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedNameRequest"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedNameRequest"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"}},"required":["description","name","tags","translatedNames"]},"SaleTranslatedNameRequest":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SaleCategoryRequest":{"type":"object","properties":{"categoryIds":{"type":"array","description":"카테고리 ID 목록","items":{"type":"string"}}},"required":["categoryIds"]},"SaleComponentsRequest":{"type":"object","properties":{"optionKey1":{"type":"string","description":"옵션 키 1"},"optionKey2":{"type":"string","description":"옵션 키 2"},"optionKey3":{"type":"string","description":"옵션 키 3"},"optionKey4":{"type":"string","description":"옵션 키 4"},"optionKey5":{"type":"string","description":"옵션 키 5"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOptionRequest"}}},"required":["options"]},"SaleOptionRequest":{"type":"object","properties":{"componentId":{"type":"string","description":"컴포넌트 ID"},"code":{"type":"string","description":"코드"},"optionValue1":{"type":"string","description":"옵션 값 1"},"optionValue2":{"type":"string","description":"옵션 값 2"},"optionValue3":{"type":"string","description":"옵션 값 3"},"optionValue4":{"type":"string","description":"옵션 값 4"},"optionValue5":{"type":"string","description":"옵션 값 5"},"price":{"$ref":"#/components/schemas/SalePriceRequest","description":"가격"}},"required":["componentId","optionValue1","price"]},"SalePriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ApiResponseSaleResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/SaleResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"SaleResponse":{"type":"object","properties":{"id":{"type":"string","description":"상품 ID"},"enterpriseId":{"type":"string","description":"기업 ID"},"userId":{"type":"string","description":"사용자 ID"},"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"},"minPrice":{"$ref":"#/components/schemas/SalePrice","description":"최소 가격"},"categories":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SaleCategory"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"},"images":{"type":"array","description":"이미지 목록","items":{"$ref":"#/components/schemas/SaleAsset"}},"components":{"$ref":"#/components/schemas/SaleComponents","description":"구성품"},"createdAt":{"type":"string","format":"date-time","description":"생성일시"},"updatedAt":{"type":"string","format":"date-time","description":"수정일시"}},"required":["categories","components","createdAt","description","id","images","name","tags","translatedNames","updatedAt","userId"]},"SaleTranslatedName":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SalePrice":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"SaleCategory":{"type":"object","properties":{"categoryId":{"type":"string","description":"카테고리 ID"},"order":{"type":"integer","format":"int32","description":"순서"}},"required":["categoryId","order"]},"SaleAsset":{"type":"object","properties":{"id":{"type":"string","description":"에셋 ID"},"name":{"type":"string","description":"에셋 이름"},"url":{"type":"string","description":"에셋 URL"}},"required":["id","name","url"]},"SaleComponents":{"type":"object","properties":{"optionKeys":{"type":"array","description":"옵션 키 목록","items":{"type":"string"}},"records":{"type":"array","description":"레코드 목록","items":{"$ref":"#/components/schemas/SaleRecord"}}},"required":["optionKeys","records"]},"SaleRecord":{"type":"object","properties":{"id":{"type":"string","description":"레코드 ID"},"order":{"type":"integer","format":"int32","description":"순서"},"price":{"$ref":"#/components/schemas/SalePrice","description":"가격"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOption"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"}},"required":["id","options","order","price"]},"SaleOption":{"type":"object","properties":{"key":{"type":"string","description":"키"},"value":{"type":"string","description":"값"}},"required":["key","value"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}":{"put":{"tags":["상품"],"summary":"상품 전체 수정","description":"상품을 전체 수정합니다.","operationId":"updateSale","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleCreateRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseSaleResponse"}}}}}}}}}
```

## 상품 목록 조회

> 엔터프라이즈의 상품 목록을 페이지네이션으로 조회합니다.\
> \
> \### 페이지네이션\
> \- offset 기반 페이징 (0부터 시작)\
> \- limit: 페이지 크기 (최소 1, 최대 100)\
> \- 응답의 hasNext로 다음 페이지 존재 여부 확인\
> \
> \### 필터 조건\
> \- userId: 사용자 ID 필터\
> \- name: 이름 검색어 (부분 일치)\
> \- code: 코드 필터\
> \- sku: SKU 필터\
> \- brandCode: 브랜드 코드 필터\
> \- categoryIds: 카테고리 ID 목록 필터\
> \- sortType: 정렬 기준 (ID\_DESC, ID\_ASC, NAME\_ASC, NAME\_DESC, UPDATED\_ASC, UPDATED\_DESC)

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"ApiResponsePageResponseSaleListItemResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/PageResponseSaleListItemResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"PageResponseSaleListItemResponse":{"type":"object","properties":{"content":{"type":"array","description":"콘텐츠 목록","items":{"$ref":"#/components/schemas/SaleListItemResponse"}},"hasNext":{"type":"boolean","description":"다음 페이지 존재 여부"},"totalCount":{"type":"integer","format":"int64","description":"전체 개수"}},"required":["content","hasNext","totalCount"]},"SaleListItemResponse":{"type":"object","properties":{"id":{"type":"string","description":"상품 ID"},"enterpriseId":{"type":"string","description":"기업 ID"},"userId":{"type":"string","description":"사용자 ID"},"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"},"minPrice":{"$ref":"#/components/schemas/SalePrice","description":"최소 가격"},"components":{"$ref":"#/components/schemas/SaleComponents","description":"구성품"},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"},"images":{"type":"array","description":"이미지 목록","items":{"$ref":"#/components/schemas/SaleAsset"}},"createdAt":{"type":"string","format":"date-time","description":"생성일시"},"updatedAt":{"type":"string","format":"date-time","description":"수정일시"}},"required":["components","createdAt","description","id","images","name","tags","translatedNames","updatedAt","userId"]},"SaleTranslatedName":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SalePrice":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"SaleComponents":{"type":"object","properties":{"optionKeys":{"type":"array","description":"옵션 키 목록","items":{"type":"string"}},"records":{"type":"array","description":"레코드 목록","items":{"$ref":"#/components/schemas/SaleRecord"}}},"required":["optionKeys","records"]},"SaleRecord":{"type":"object","properties":{"id":{"type":"string","description":"레코드 ID"},"order":{"type":"integer","format":"int32","description":"순서"},"price":{"$ref":"#/components/schemas/SalePrice","description":"가격"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOption"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"}},"required":["id","options","order","price"]},"SaleOption":{"type":"object","properties":{"key":{"type":"string","description":"키"},"value":{"type":"string","description":"값"}},"required":["key","value"]},"SaleAsset":{"type":"object","properties":{"id":{"type":"string","description":"에셋 ID"},"name":{"type":"string","description":"에셋 이름"},"url":{"type":"string","description":"에셋 URL"}},"required":["id","name","url"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales":{"get":{"tags":["상품"],"summary":"상품 목록 조회","description":"엔터프라이즈의 상품 목록을 페이지네이션으로 조회합니다.\n\n### 페이지네이션\n- offset 기반 페이징 (0부터 시작)\n- limit: 페이지 크기 (최소 1, 최대 100)\n- 응답의 hasNext로 다음 페이지 존재 여부 확인\n\n### 필터 조건\n- userId: 사용자 ID 필터\n- name: 이름 검색어 (부분 일치)\n- code: 코드 필터\n- sku: SKU 필터\n- brandCode: 브랜드 코드 필터\n- categoryIds: 카테고리 ID 목록 필터\n- sortType: 정렬 기준 (ID_DESC, ID_ASC, NAME_ASC, NAME_DESC, UPDATED_ASC, UPDATED_DESC)","operationId":"searchSales","parameters":[{"name":"offset","in":"query","description":"페이지 번호 (0부터 시작, offset 페이징)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"페이지 크기 (최소: 1, 최대: 100)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"userId","in":"query","description":"사용자 ID","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","description":"이름 검색어","required":false,"schema":{"type":"string"}},{"name":"code","in":"query","description":"코드","required":false,"schema":{"type":"string"}},{"name":"sku","in":"query","description":"SKU","required":false,"schema":{"type":"string"}},{"name":"brandCode","in":"query","description":"브랜드 코드","required":false,"schema":{"type":"string"}},{"name":"categoryIds","in":"query","description":"카테고리 ID 목록","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"sortType","in":"query","description":"정렬 기준","required":false,"schema":{"type":"string","default":"ID_DESC","description":"정렬 타입","enum":["ID_DESC","ID_ASC","NAME_ASC","NAME_DESC","UPDATED_ASC","UPDATED_DESC"]}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponsePageResponseSaleListItemResponse"}}}}}}}}}
```

## 상품 생성

> 새 상품을 생성합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleCreateRequest":{"type":"object","properties":{"info":{"$ref":"#/components/schemas/SaleInfoRequest","description":"상품 정보"},"previewImage":{"type":"string","description":"대표 이미지 ID"},"images":{"type":"array","description":"이미지 ID 목록","items":{"type":"string"}},"category":{"$ref":"#/components/schemas/SaleCategoryRequest","description":"카테고리"},"components":{"$ref":"#/components/schemas/SaleComponentsRequest","description":"구성품"},"isPersonal":{"type":"boolean","description":"개인 여부"}},"required":["images","info","isPersonal"]},"SaleInfoRequest":{"type":"object","properties":{"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedNameRequest"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedNameRequest"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"}},"required":["description","name","tags","translatedNames"]},"SaleTranslatedNameRequest":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SaleCategoryRequest":{"type":"object","properties":{"categoryIds":{"type":"array","description":"카테고리 ID 목록","items":{"type":"string"}}},"required":["categoryIds"]},"SaleComponentsRequest":{"type":"object","properties":{"optionKey1":{"type":"string","description":"옵션 키 1"},"optionKey2":{"type":"string","description":"옵션 키 2"},"optionKey3":{"type":"string","description":"옵션 키 3"},"optionKey4":{"type":"string","description":"옵션 키 4"},"optionKey5":{"type":"string","description":"옵션 키 5"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOptionRequest"}}},"required":["options"]},"SaleOptionRequest":{"type":"object","properties":{"componentId":{"type":"string","description":"컴포넌트 ID"},"code":{"type":"string","description":"코드"},"optionValue1":{"type":"string","description":"옵션 값 1"},"optionValue2":{"type":"string","description":"옵션 값 2"},"optionValue3":{"type":"string","description":"옵션 값 3"},"optionValue4":{"type":"string","description":"옵션 값 4"},"optionValue5":{"type":"string","description":"옵션 값 5"},"price":{"$ref":"#/components/schemas/SalePriceRequest","description":"가격"}},"required":["componentId","optionValue1","price"]},"SalePriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ApiResponseSaleResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/SaleResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"SaleResponse":{"type":"object","properties":{"id":{"type":"string","description":"상품 ID"},"enterpriseId":{"type":"string","description":"기업 ID"},"userId":{"type":"string","description":"사용자 ID"},"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"},"minPrice":{"$ref":"#/components/schemas/SalePrice","description":"최소 가격"},"categories":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SaleCategory"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"},"images":{"type":"array","description":"이미지 목록","items":{"$ref":"#/components/schemas/SaleAsset"}},"components":{"$ref":"#/components/schemas/SaleComponents","description":"구성품"},"createdAt":{"type":"string","format":"date-time","description":"생성일시"},"updatedAt":{"type":"string","format":"date-time","description":"수정일시"}},"required":["categories","components","createdAt","description","id","images","name","tags","translatedNames","updatedAt","userId"]},"SaleTranslatedName":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SalePrice":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"SaleCategory":{"type":"object","properties":{"categoryId":{"type":"string","description":"카테고리 ID"},"order":{"type":"integer","format":"int32","description":"순서"}},"required":["categoryId","order"]},"SaleAsset":{"type":"object","properties":{"id":{"type":"string","description":"에셋 ID"},"name":{"type":"string","description":"에셋 이름"},"url":{"type":"string","description":"에셋 URL"}},"required":["id","name","url"]},"SaleComponents":{"type":"object","properties":{"optionKeys":{"type":"array","description":"옵션 키 목록","items":{"type":"string"}},"records":{"type":"array","description":"레코드 목록","items":{"$ref":"#/components/schemas/SaleRecord"}}},"required":["optionKeys","records"]},"SaleRecord":{"type":"object","properties":{"id":{"type":"string","description":"레코드 ID"},"order":{"type":"integer","format":"int32","description":"순서"},"price":{"$ref":"#/components/schemas/SalePrice","description":"가격"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOption"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"}},"required":["id","options","order","price"]},"SaleOption":{"type":"object","properties":{"key":{"type":"string","description":"키"},"value":{"type":"string","description":"값"}},"required":["key","value"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales":{"post":{"tags":["상품"],"summary":"상품 생성","description":"새 상품을 생성합니다.","operationId":"createSale","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleCreateRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseSaleResponse"}}}}}}}}}
```

## 상품 옵션 추가

> 상품에 옵션을 추가합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleModifyOptionsRequest":{"type":"object","properties":{"optionKey1":{"type":"string","description":"옵션 키 1"},"optionKey2":{"type":"string","description":"옵션 키 2"},"optionKey3":{"type":"string","description":"옵션 키 3"},"optionKey4":{"type":"string","description":"옵션 키 4"},"optionKey5":{"type":"string","description":"옵션 키 5"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOptionRequest"}}},"required":["options"]},"SaleOptionRequest":{"type":"object","properties":{"componentId":{"type":"string","description":"컴포넌트 ID"},"code":{"type":"string","description":"코드"},"optionValue1":{"type":"string","description":"옵션 값 1"},"optionValue2":{"type":"string","description":"옵션 값 2"},"optionValue3":{"type":"string","description":"옵션 값 3"},"optionValue4":{"type":"string","description":"옵션 값 4"},"optionValue5":{"type":"string","description":"옵션 값 5"},"price":{"$ref":"#/components/schemas/SalePriceRequest","description":"가격"}},"required":["componentId","optionValue1","price"]},"SalePriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ApiResponseUnit":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}/options":{"post":{"tags":["상품"],"summary":"상품 옵션 추가","description":"상품에 옵션을 추가합니다.","operationId":"addSaleOptions","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleModifyOptionsRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseUnit"}}}}}}}}}
```

## 상품 옵션 삭제

> 상품의 옵션을 삭제합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleDeleteOptionsRequest":{"type":"object","properties":{"ids":{"type":"array","description":"삭제할 옵션 ID 목록","items":{"type":"string"}},"deleteSaleIfEmpty":{"type":"boolean","description":"옵션이 비면 상품도 삭제할지 여부"}},"required":["deleteSaleIfEmpty","ids"]},"ApiResponseUnit":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}/options":{"delete":{"tags":["상품"],"summary":"상품 옵션 삭제","description":"상품의 옵션을 삭제합니다.","operationId":"deleteSaleOptions","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleDeleteOptionsRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseUnit"}}}}}}}}}
```

## 상품 옵션 수정

> 상품의 옵션을 수정합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleModifyOptionsRequest":{"type":"object","properties":{"optionKey1":{"type":"string","description":"옵션 키 1"},"optionKey2":{"type":"string","description":"옵션 키 2"},"optionKey3":{"type":"string","description":"옵션 키 3"},"optionKey4":{"type":"string","description":"옵션 키 4"},"optionKey5":{"type":"string","description":"옵션 키 5"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOptionRequest"}}},"required":["options"]},"SaleOptionRequest":{"type":"object","properties":{"componentId":{"type":"string","description":"컴포넌트 ID"},"code":{"type":"string","description":"코드"},"optionValue1":{"type":"string","description":"옵션 값 1"},"optionValue2":{"type":"string","description":"옵션 값 2"},"optionValue3":{"type":"string","description":"옵션 값 3"},"optionValue4":{"type":"string","description":"옵션 값 4"},"optionValue5":{"type":"string","description":"옵션 값 5"},"price":{"$ref":"#/components/schemas/SalePriceRequest","description":"가격"}},"required":["componentId","optionValue1","price"]},"SalePriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ApiResponseUnit":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}/options":{"patch":{"tags":["상품"],"summary":"상품 옵션 수정","description":"상품의 옵션을 수정합니다.","operationId":"modifySaleOptions","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleModifyOptionsRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseUnit"}}}}}}}}}
```

## 상품 통합

> 상품을 통합합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleMergeRequest":{"type":"object","properties":{"name":{"type":"string","description":"이름"},"previewImage":{"$ref":"#/components/schemas/SalePreviewImageRequest","description":"대표 이미지"},"optionKey":{"type":"string","description":"옵션 키"},"brandCode":{"type":"string","description":"브랜드 코드"},"salesToMerge":{"type":"array","description":"통합할 상품 목록","items":{"$ref":"#/components/schemas/SaleToMergeRequest"}}},"required":["name","optionKey","salesToMerge"]},"SalePreviewImageRequest":{"type":"object","properties":{"file":{"type":"string","description":"파일 Base64"},"fileName":{"type":"string","description":"파일명"}},"required":["file","fileName"]},"SaleToMergeRequest":{"type":"object","properties":{"saleId":{"type":"string","description":"상품 ID"},"optionValue":{"type":"string","description":"옵션 값"}},"required":["optionValue","saleId"]},"ApiResponseSaleResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/SaleResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"SaleResponse":{"type":"object","properties":{"id":{"type":"string","description":"상품 ID"},"enterpriseId":{"type":"string","description":"기업 ID"},"userId":{"type":"string","description":"사용자 ID"},"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"},"minPrice":{"$ref":"#/components/schemas/SalePrice","description":"최소 가격"},"categories":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SaleCategory"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"},"images":{"type":"array","description":"이미지 목록","items":{"$ref":"#/components/schemas/SaleAsset"}},"components":{"$ref":"#/components/schemas/SaleComponents","description":"구성품"},"createdAt":{"type":"string","format":"date-time","description":"생성일시"},"updatedAt":{"type":"string","format":"date-time","description":"수정일시"}},"required":["categories","components","createdAt","description","id","images","name","tags","translatedNames","updatedAt","userId"]},"SaleTranslatedName":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SalePrice":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"SaleCategory":{"type":"object","properties":{"categoryId":{"type":"string","description":"카테고리 ID"},"order":{"type":"integer","format":"int32","description":"순서"}},"required":["categoryId","order"]},"SaleAsset":{"type":"object","properties":{"id":{"type":"string","description":"에셋 ID"},"name":{"type":"string","description":"에셋 이름"},"url":{"type":"string","description":"에셋 URL"}},"required":["id","name","url"]},"SaleComponents":{"type":"object","properties":{"optionKeys":{"type":"array","description":"옵션 키 목록","items":{"type":"string"}},"records":{"type":"array","description":"레코드 목록","items":{"$ref":"#/components/schemas/SaleRecord"}}},"required":["optionKeys","records"]},"SaleRecord":{"type":"object","properties":{"id":{"type":"string","description":"레코드 ID"},"order":{"type":"integer","format":"int32","description":"순서"},"price":{"$ref":"#/components/schemas/SalePrice","description":"가격"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOption"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"}},"required":["id","options","order","price"]},"SaleOption":{"type":"object","properties":{"key":{"type":"string","description":"키"},"value":{"type":"string","description":"값"}},"required":["key","value"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/merge":{"post":{"tags":["상품"],"summary":"상품 통합","description":"상품을 통합합니다.","operationId":"mergeSales","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleMergeRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseSaleResponse"}}}}}}}}}
```

## 상품 분해

> 상품을 분해합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleDecomposeRequest":{"type":"object","properties":{"saleIds":{"type":"array","description":"분해할 상품 ID 목록","items":{"type":"string"}}},"required":["saleIds"]},"ApiResponseListSaleResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"type":"array","description":"응답 데이터","items":{"$ref":"#/components/schemas/SaleResponse"}},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"SaleResponse":{"type":"object","properties":{"id":{"type":"string","description":"상품 ID"},"enterpriseId":{"type":"string","description":"기업 ID"},"userId":{"type":"string","description":"사용자 ID"},"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedName"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"},"minPrice":{"$ref":"#/components/schemas/SalePrice","description":"최소 가격"},"categories":{"type":"array","description":"카테고리 목록","items":{"$ref":"#/components/schemas/SaleCategory"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"},"images":{"type":"array","description":"이미지 목록","items":{"$ref":"#/components/schemas/SaleAsset"}},"components":{"$ref":"#/components/schemas/SaleComponents","description":"구성품"},"createdAt":{"type":"string","format":"date-time","description":"생성일시"},"updatedAt":{"type":"string","format":"date-time","description":"수정일시"}},"required":["categories","components","createdAt","description","id","images","name","tags","translatedNames","updatedAt","userId"]},"SaleTranslatedName":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"SalePrice":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"SaleCategory":{"type":"object","properties":{"categoryId":{"type":"string","description":"카테고리 ID"},"order":{"type":"integer","format":"int32","description":"순서"}},"required":["categoryId","order"]},"SaleAsset":{"type":"object","properties":{"id":{"type":"string","description":"에셋 ID"},"name":{"type":"string","description":"에셋 이름"},"url":{"type":"string","description":"에셋 URL"}},"required":["id","name","url"]},"SaleComponents":{"type":"object","properties":{"optionKeys":{"type":"array","description":"옵션 키 목록","items":{"type":"string"}},"records":{"type":"array","description":"레코드 목록","items":{"$ref":"#/components/schemas/SaleRecord"}}},"required":["optionKeys","records"]},"SaleRecord":{"type":"object","properties":{"id":{"type":"string","description":"레코드 ID"},"order":{"type":"integer","format":"int32","description":"순서"},"price":{"$ref":"#/components/schemas/SalePrice","description":"가격"},"options":{"type":"array","description":"옵션 목록","items":{"$ref":"#/components/schemas/SaleOption"}},"previewImage":{"$ref":"#/components/schemas/SaleAsset","description":"대표 이미지"}},"required":["id","options","order","price"]},"SaleOption":{"type":"object","properties":{"key":{"type":"string","description":"키"},"value":{"type":"string","description":"값"}},"required":["key","value"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/decompose":{"post":{"tags":["상품"],"summary":"상품 분해","description":"상품을 분해합니다.","operationId":"decomposeSales","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleDecomposeRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseListSaleResponse"}}}}}}}}}
```

## 상품 옵션 가격 수정

> 상품 옵션의 가격을 수정합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleModifyPriceRequest":{"type":"object","properties":{"price":{"$ref":"#/components/schemas/SalePriceRequest","description":"가격"}},"required":["price"]},"SalePriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ApiResponseUnit":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}/options/{componentId}/price":{"patch":{"tags":["상품"],"summary":"상품 옵션 가격 수정","description":"상품 옵션의 가격을 수정합니다.","operationId":"modifySaleOptionPrice","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}},{"name":"componentId","in":"path","description":"컴포넌트 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleModifyPriceRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseUnit"}}}}}}}}}
```

## 상품 기본정보 수정

> 상품의 기본정보를 수정합니다.

```json
{"openapi":"3.1.0","info":{"title":"Open API","version":"snapshot"},"tags":[{"name":"상품"}],"servers":[{"url":"https://openapi.archisketch.com"}],"security":[{"open-api-key":[]}],"components":{"securitySchemes":{"open-api-key":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"SaleModifyInfoRequest":{"type":"object","properties":{"name":{"type":"string","description":"이름"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/SaleTranslatedNameRequest"}},"description":{"type":"array","description":"설명","items":{"$ref":"#/components/schemas/SaleTranslatedNameRequest"}},"tags":{"type":"array","description":"태그","items":{"type":"string"}},"brandCode":{"type":"string","description":"브랜드 코드"},"code":{"type":"string","description":"코드"},"website":{"type":"string","description":"웹사이트"}},"required":["description","name","tags","translatedNames"]},"SaleTranslatedNameRequest":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 값"}},"required":["code","value"]},"ApiResponseUnit":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/sales/{id}/info":{"patch":{"tags":["상품"],"summary":"상품 기본정보 수정","description":"상품의 기본정보를 수정합니다.","operationId":"modifySaleInfo","parameters":[{"name":"id","in":"path","description":"상품 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleModifyInfoRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseUnit"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.archisketch.com/dev/api-3/undefined-7.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.