# 파라메트릭

## 파라메트릭 컴포넌트 수정

> 파라메트릭 컴포넌트를 수정한다.

```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":{"ParametricComponentModifyRequest":{"type":"object","properties":{"name":{"type":"string","description":"이름"},"parametricType":{"type":"string","description":"파라메트릭 유형 (assembly | modeling)"},"code":{"type":"string","description":"코드"},"brandCode":{"type":"string","description":"브랜드 코드"},"namespace":{"type":"string","description":"네임스페이스"},"color":{"$ref":"#/components/schemas/ParametricColorRequest","description":"색상"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/ParametricTranslatedNameRequest"}},"type":{"type":"string","description":"타입"},"status":{"type":"string","description":"상태"},"sku":{"type":"string","description":"SKU"},"dimension":{"$ref":"#/components/schemas/ParametricDimensionRequest","description":"치수"},"retailPrice":{"$ref":"#/components/schemas/ParametricPriceRequest","description":"소비자가"},"factoryPrice":{"$ref":"#/components/schemas/ParametricPriceRequest","description":"공장가"},"mainMaterial":{"type":"string","description":"주재료"},"subMaterial":{"type":"string","description":"부재료"},"rawMaterial":{"type":"string","description":"원재료"},"unit":{"type":"string","description":"단위"},"version":{"type":"string","description":"버전"},"extra":{"type":"object","additionalProperties":{},"description":"추가 정보 (snapPoints, snapLines, componentCategory, componentType 등)"},"modelingId":{"type":"string","description":"모델링 ID"},"category":{"$ref":"#/components/schemas/ParametricCategoryRequest","description":"카테고리"},"parameters":{"type":"array","description":"파라미터 목록","items":{"$ref":"#/components/schemas/ParametricParameterRequest"}},"compositions":{"type":"array","description":"컴포지션 목록","items":{"$ref":"#/components/schemas/ParametricCompositionRequest"}},"parametricModeling":{"$ref":"#/components/schemas/ParametricModelingRequest","description":"파라메트릭 모델링 (modeling 타입일 때 사용)"},"glbUrl":{"type":"string","description":"GLB URL"},"previewImage":{"type":"string","description":"미리보기 이미지 URL"},"images":{"type":"array","description":"이미지 URL 목록","items":{"type":"string"}},"editorSetting":{"$ref":"#/components/schemas/ParametricEditorSettingRequest","description":"에디터 설정"}},"required":["compositions","dimension","images","name","parameters","parametricType","translatedNames"]},"ParametricColorRequest":{"type":"object","properties":{"code":{"type":"string","description":"색상 코드"},"name":{"type":"string","description":"색상 이름"}},"required":["code","name"]},"ParametricTranslatedNameRequest":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 이름"}},"required":["code","value"]},"ParametricDimensionRequest":{"type":"object","properties":{"mm":{"$ref":"#/components/schemas/ParametricDimensionValue","description":"mm 단위 치수"},"inch":{"$ref":"#/components/schemas/ParametricDimensionValue","description":"인치 단위 치수"}}},"ParametricDimensionValue":{"type":"object","properties":{"width":{"type":"number","description":"너비"},"depth":{"type":"number","description":"깊이"},"height":{"type":"number","description":"높이"}},"required":["depth","height","width"]},"ParametricPriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ParametricCategoryRequest":{"type":"object","properties":{"categoryIds":{"type":"array","description":"카테고리 ID 목록","items":{"type":"string"}}},"required":["categoryIds"]},"ParametricParameterRequest":{"type":"object","properties":{"displayName":{"type":"string","description":"표시 이름"},"referenceName":{"type":"string","description":"참조 이름"},"type":{"type":"string","description":"파라미터 타입"},"valueInfo":{"$ref":"#/components/schemas/ParametricParameterValueInfoRequest","description":"값 정보"},"priority":{"type":"integer","format":"int32","description":"우선순위"},"description":{"type":"string","description":"설명"},"hideCondition":{"type":"string","description":"숨김 조건 표현식"},"enterpriseParameterId":{"type":"string","description":"기업 파라미터 ID"}},"required":["displayName","priority","referenceName","type","valueInfo"]},"ParametricParameterValueInfoRequest":{"type":"object","properties":{"usage":{"type":"string","description":"사용 방식"},"value":{"type":"string","description":"기본값"},"optionType":{"type":"string","description":"옵션 타입"},"options":{"type":"object","additionalProperties":{},"description":"옵션 값 — RANGE: {min,max,stepSize} / CANDIDATE: {values:[...]} / FORMULA: {formulaExpression:\"...\"}"}},"required":["usage","value"]},"ParametricCompositionRequest":{"type":"object","properties":{"componentId":{"type":"string","description":"자식 컴포넌트 ID"},"recipeJson":{"type":"string","description":"레시피 JSON (stringify)"},"animation":{"$ref":"#/components/schemas/ParametricCompositionAnimationRequest","description":"애니메이션 설정"}},"required":["componentId","recipeJson"]},"ParametricCompositionAnimationRequest":{"type":"object","properties":{"type":{"type":"string","description":"애니메이션 타입"},"animationName":{"type":"string","description":"애니메이션 이름"},"animationDuration":{"type":"number","format":"double","description":"애니메이션 지속 시간(초)"},"animationDelay":{"type":"number","format":"double","description":"애니메이션 딜레이(초)"},"animationDirection":{"type":"string","description":"애니메이션 방향"},"animationIterationCount":{"type":"integer","format":"int32","description":"애니메이션 반복 횟수"},"pivot":{"type":"object","additionalProperties":{},"description":"[AXIS_ROTATION] pivot point"},"axis":{"type":"object","additionalProperties":{},"description":"[AXIS_ROTATION] 회전 축"},"angle":{"type":"number","format":"double","description":"[AXIS_ROTATION] 회전 각도"},"direction":{"type":"object","additionalProperties":{},"description":"[TRANSLATION] 이동 방향"},"distance":{"description":"[TRANSLATION] 이동 거리"}},"required":["animationDelay","animationDirection","animationDuration","animationIterationCount","animationName","type"]},"ParametricModelingRequest":{"type":"object","properties":{"name":{"type":"string","description":"파라메트릭 모델링 이름"},"json":{"type":"string","description":"shape 정의 JSON"}},"required":["json","name"]},"ParametricEditorSettingRequest":{"type":"object","properties":{"editorType":{"type":"string","description":"에디터 타입","enum":["FLOOR_ITEM","STANDING_ITEM","WALL_ITEM","CEILING_ITEM","SWING_DOOR","SLIDING_DOOR","FOLDING_DOOR","GARAGE_DOOR","SWING_WINDOW","SLIDING_WINDOW","FOLDING_WINDOW","STANDARD_WINDOW","SPACE"]},"dimensionLock":{"$ref":"#/components/schemas/ParametricDimensionLockRequest","description":"치수 잠금 설정"},"door":{"$ref":"#/components/schemas/ParametricEditorDoorRequest","description":"도어 설정 (도어가 있는 부품에만 사용)"}},"required":["dimensionLock","editorType"]},"ParametricDimensionLockRequest":{"type":"object","properties":{"width":{"type":"boolean","default":false,"description":"너비 잠금"},"depth":{"type":"boolean","default":false,"description":"깊이 잠금"},"height":{"type":"boolean","default":false,"description":"높이 잠금"}}},"ParametricEditorDoorRequest":{"type":"object","properties":{"isOpen":{"type":"boolean","description":"도어 열림 여부"},"openDirection":{"type":"string","description":"열림 방향 (LEFT | RIGHT)"},"handlePosition":{"type":"string","description":"손잡이 위치 (LEFT | RIGHT | TOP | BOTTOM)"}},"required":["handlePosition","isOpen","openDirection"]},"ApiResponseParametricComponentIdResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/ParametricComponentIdResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ParametricComponentIdResponse":{"type":"object","properties":{"componentId":{"type":"string","description":"생성된 컴포넌트 ID"}},"required":["componentId"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/parametric/components/{id}":{"put":{"tags":["파라메트릭"],"summary":"파라메트릭 컴포넌트 수정","description":"파라메트릭 컴포넌트를 수정한다.","operationId":"modifyParametricComponent","parameters":[{"name":"id","in":"path","description":"컴포넌트 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"수정할 파라메트릭 컴포넌트 정보","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParametricComponentModifyRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseParametricComponentIdResponse"}}}}}}}}}
```

## 파라메트릭 컴포넌트 생성

> 새 파라메트릭 컴포넌트를 생성한다.

```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":{"ParametricComponentCreateRequest":{"type":"object","properties":{"name":{"type":"string","description":"이름"},"parametricType":{"type":"string","description":"파라메트릭 유형 (assembly | modeling)"},"code":{"type":"string","description":"코드"},"brandCode":{"type":"string","description":"브랜드 코드"},"namespace":{"type":"string","description":"네임스페이스"},"color":{"$ref":"#/components/schemas/ParametricColorRequest","description":"색상"},"translatedNames":{"type":"array","description":"다국어 이름","items":{"$ref":"#/components/schemas/ParametricTranslatedNameRequest"}},"type":{"type":"string","description":"타입"},"status":{"type":"string","description":"상태"},"sku":{"type":"string","description":"SKU"},"dimension":{"$ref":"#/components/schemas/ParametricDimensionRequest","description":"치수"},"retailPrice":{"$ref":"#/components/schemas/ParametricPriceRequest","description":"소비자가"},"factoryPrice":{"$ref":"#/components/schemas/ParametricPriceRequest","description":"공장가"},"mainMaterial":{"type":"string","description":"주재료"},"subMaterial":{"type":"string","description":"부재료"},"rawMaterial":{"type":"string","description":"원재료"},"unit":{"type":"string","description":"단위"},"version":{"type":"string","description":"버전"},"extra":{"type":"object","additionalProperties":{},"description":"추가 정보 (snapPoints, snapLines, componentCategory, componentType 등)"},"modelingId":{"type":"string","description":"모델링 ID"},"category":{"$ref":"#/components/schemas/ParametricCategoryRequest","description":"카테고리"},"parameters":{"type":"array","description":"파라미터 목록","items":{"$ref":"#/components/schemas/ParametricParameterRequest"}},"compositions":{"type":"array","description":"컴포지션 목록","items":{"$ref":"#/components/schemas/ParametricCompositionRequest"}},"parametricModeling":{"$ref":"#/components/schemas/ParametricModelingRequest","description":"파라메트릭 모델링 (modeling 타입일 때 사용)"},"glbUrl":{"type":"string","description":"GLB URL"},"isFinal":{"type":"boolean","default":false,"description":"최종 부품 여부"},"isPersonal":{"type":"boolean","default":false,"description":"개인 라이브러리 여부. true이면 enterpriseId 없이 저장됨"},"previewImage":{"type":"string","description":"미리보기 이미지 URL"},"images":{"type":"array","description":"이미지 URL 목록","items":{"type":"string"}},"editorSetting":{"$ref":"#/components/schemas/ParametricEditorSettingRequest","description":"에디터 설정"}},"required":["compositions","dimension","images","name","parameters","parametricType","translatedNames"]},"ParametricColorRequest":{"type":"object","properties":{"code":{"type":"string","description":"색상 코드"},"name":{"type":"string","description":"색상 이름"}},"required":["code","name"]},"ParametricTranslatedNameRequest":{"type":"object","properties":{"code":{"type":"string","description":"언어 코드"},"value":{"type":"string","description":"번역된 이름"}},"required":["code","value"]},"ParametricDimensionRequest":{"type":"object","properties":{"mm":{"$ref":"#/components/schemas/ParametricDimensionValue","description":"mm 단위 치수"},"inch":{"$ref":"#/components/schemas/ParametricDimensionValue","description":"인치 단위 치수"}}},"ParametricDimensionValue":{"type":"object","properties":{"width":{"type":"number","description":"너비"},"depth":{"type":"number","description":"깊이"},"height":{"type":"number","description":"높이"}},"required":["depth","height","width"]},"ParametricPriceRequest":{"type":"object","properties":{"value":{"type":"number","description":"가격"},"unit":{"type":"string","description":"통화 단위","enum":["KRW","USD","EUR","JPY","GBP","CNY","VND","TWD"]}},"required":["unit","value"]},"ParametricCategoryRequest":{"type":"object","properties":{"categoryIds":{"type":"array","description":"카테고리 ID 목록","items":{"type":"string"}}},"required":["categoryIds"]},"ParametricParameterRequest":{"type":"object","properties":{"displayName":{"type":"string","description":"표시 이름"},"referenceName":{"type":"string","description":"참조 이름"},"type":{"type":"string","description":"파라미터 타입"},"valueInfo":{"$ref":"#/components/schemas/ParametricParameterValueInfoRequest","description":"값 정보"},"priority":{"type":"integer","format":"int32","description":"우선순위"},"description":{"type":"string","description":"설명"},"hideCondition":{"type":"string","description":"숨김 조건 표현식"},"enterpriseParameterId":{"type":"string","description":"기업 파라미터 ID"}},"required":["displayName","priority","referenceName","type","valueInfo"]},"ParametricParameterValueInfoRequest":{"type":"object","properties":{"usage":{"type":"string","description":"사용 방식"},"value":{"type":"string","description":"기본값"},"optionType":{"type":"string","description":"옵션 타입"},"options":{"type":"object","additionalProperties":{},"description":"옵션 값 — RANGE: {min,max,stepSize} / CANDIDATE: {values:[...]} / FORMULA: {formulaExpression:\"...\"}"}},"required":["usage","value"]},"ParametricCompositionRequest":{"type":"object","properties":{"componentId":{"type":"string","description":"자식 컴포넌트 ID"},"recipeJson":{"type":"string","description":"레시피 JSON (stringify)"},"animation":{"$ref":"#/components/schemas/ParametricCompositionAnimationRequest","description":"애니메이션 설정"}},"required":["componentId","recipeJson"]},"ParametricCompositionAnimationRequest":{"type":"object","properties":{"type":{"type":"string","description":"애니메이션 타입"},"animationName":{"type":"string","description":"애니메이션 이름"},"animationDuration":{"type":"number","format":"double","description":"애니메이션 지속 시간(초)"},"animationDelay":{"type":"number","format":"double","description":"애니메이션 딜레이(초)"},"animationDirection":{"type":"string","description":"애니메이션 방향"},"animationIterationCount":{"type":"integer","format":"int32","description":"애니메이션 반복 횟수"},"pivot":{"type":"object","additionalProperties":{},"description":"[AXIS_ROTATION] pivot point"},"axis":{"type":"object","additionalProperties":{},"description":"[AXIS_ROTATION] 회전 축"},"angle":{"type":"number","format":"double","description":"[AXIS_ROTATION] 회전 각도"},"direction":{"type":"object","additionalProperties":{},"description":"[TRANSLATION] 이동 방향"},"distance":{"description":"[TRANSLATION] 이동 거리"}},"required":["animationDelay","animationDirection","animationDuration","animationIterationCount","animationName","type"]},"ParametricModelingRequest":{"type":"object","properties":{"name":{"type":"string","description":"파라메트릭 모델링 이름"},"json":{"type":"string","description":"shape 정의 JSON"}},"required":["json","name"]},"ParametricEditorSettingRequest":{"type":"object","properties":{"editorType":{"type":"string","description":"에디터 타입","enum":["FLOOR_ITEM","STANDING_ITEM","WALL_ITEM","CEILING_ITEM","SWING_DOOR","SLIDING_DOOR","FOLDING_DOOR","GARAGE_DOOR","SWING_WINDOW","SLIDING_WINDOW","FOLDING_WINDOW","STANDARD_WINDOW","SPACE"]},"dimensionLock":{"$ref":"#/components/schemas/ParametricDimensionLockRequest","description":"치수 잠금 설정"},"door":{"$ref":"#/components/schemas/ParametricEditorDoorRequest","description":"도어 설정 (도어가 있는 부품에만 사용)"}},"required":["dimensionLock","editorType"]},"ParametricDimensionLockRequest":{"type":"object","properties":{"width":{"type":"boolean","default":false,"description":"너비 잠금"},"depth":{"type":"boolean","default":false,"description":"깊이 잠금"},"height":{"type":"boolean","default":false,"description":"높이 잠금"}}},"ParametricEditorDoorRequest":{"type":"object","properties":{"isOpen":{"type":"boolean","description":"도어 열림 여부"},"openDirection":{"type":"string","description":"열림 방향 (LEFT | RIGHT)"},"handlePosition":{"type":"string","description":"손잡이 위치 (LEFT | RIGHT | TOP | BOTTOM)"}},"required":["handlePosition","isOpen","openDirection"]},"ApiResponseParametricComponentIdResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/ParametricComponentIdResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ParametricComponentIdResponse":{"type":"object","properties":{"componentId":{"type":"string","description":"생성된 컴포넌트 ID"}},"required":["componentId"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/parametric":{"post":{"tags":["파라메트릭"],"summary":"파라메트릭 컴포넌트 생성","description":"새 파라메트릭 컴포넌트를 생성한다.","operationId":"createParametricComponent","requestBody":{"description":"생성할 파라메트릭 컴포넌트 정보","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParametricComponentCreateRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseParametricComponentIdResponse"}}}}}}}}}
```

## 컴포넌트 파라미터 목록 조회

> 파라메트릭 컴포넌트의 파라미터 목록을 조회한다.

```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":{"ApiResponseComponentParametersResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/ComponentParametersResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ComponentParametersResponse":{"type":"object","properties":{"parameters":{"type":"array","description":"생성된 파라미터 목록","items":{"$ref":"#/components/schemas/ParameterResponse"}}},"required":["parameters"]},"ParameterResponse":{"type":"object","properties":{"id":{"type":"string","description":"파라미터 ID"},"displayName":{"type":"string","description":"표시 이름"},"referenceName":{"type":"string","description":"참조 이름"},"type":{"type":"string","description":"파라미터 타입","enum":["SYSTEM","BASIC","CUSTOM","INTERNAL"]},"valueInfo":{"$ref":"#/components/schemas/ParameterValueInfoResponse","description":"값 정보"},"priority":{"type":"integer","format":"int32","description":"우선순위"},"description":{"type":"string","description":"설명"},"hideCondition":{"type":"string","description":"숨김 조건 표현식"},"enterpriseParameterId":{"type":"string","description":"기업 파라미터 ID"}},"required":["displayName","id","priority","referenceName","type","valueInfo"]},"ParameterValueInfoResponse":{"type":"object","properties":{"usage":{"type":"string","description":"사용 방식"},"value":{"type":"string","description":"현재 값"},"optionType":{"type":"string","description":"옵션 타입","enum":["RANGE","CANDIDATE","CATEGORY","TEXT_WITH_IMAGES","UNLIMITED","FORMULA"]},"options":{"$ref":"#/components/schemas/ParameterOptionsResponse","description":"옵션 값"}},"required":["usage","value"]},"ParameterOptionsResponse":{"type":"object","properties":{"min":{"type":"string","description":"[RANGE] 최솟값"},"max":{"type":"string","description":"[RANGE] 최댓값"},"stepSize":{"type":"string","description":"[RANGE] 단계 크기"},"values":{"type":"array","description":"[CANDIDATE|CATEGORY|UNLIMITED] 값 목록","items":{"type":"string"}},"textWithImagesValues":{"type":"array","description":"[TEXT_WITH_IMAGES] 텍스트+이미지 목록","items":{"$ref":"#/components/schemas/TextWithImagesItemResponse"}},"formulaExpression":{"type":"string","description":"[FORMULA] 수식 표현식"}}},"TextWithImagesItemResponse":{"type":"object","properties":{"text":{"type":"string","description":"텍스트"},"imageUrl":{"type":"string","description":"이미지 URL"}},"required":["imageUrl","text"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/parametric/components/{componentId}/parameters":{"get":{"tags":["파라메트릭"],"summary":"컴포넌트 파라미터 목록 조회","description":"파라메트릭 컴포넌트의 파라미터 목록을 조회한다.","operationId":"getComponentParameters","parameters":[{"name":"componentId","in":"path","description":"컴포넌트 ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseComponentParametersResponse"}}}}}}}}}
```

## 컴포넌트 파라미터 생성

> 파라메트릭 컴포넌트에 파라미터를 생성한다.

```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":{"ComponentParametersCreateRequest":{"type":"object","properties":{"parameters":{"type":"array","description":"생성할 파라미터 목록","items":{"$ref":"#/components/schemas/ParameterRequest"}}},"required":["parameters"]},"ParameterRequest":{"type":"object","properties":{"displayName":{"type":"string","description":"표시 이름"},"referenceName":{"type":"string","description":"참조 이름"},"type":{"type":"string","description":"파라미터 타입","enum":["SYSTEM","BASIC","CUSTOM","INTERNAL"]},"valueInfo":{"$ref":"#/components/schemas/ParameterValueInfoRequest","description":"값 정보"},"priority":{"type":"integer","format":"int32","description":"우선순위"},"description":{"type":"string","description":"설명"},"hideCondition":{"type":"string","description":"숨김 조건 표현식"},"enterpriseParameterId":{"type":"string","description":"기업 파라미터 ID"}},"required":["displayName","priority","referenceName","type","valueInfo"]},"ParameterValueInfoRequest":{"type":"object","properties":{"usage":{"type":"string","description":"사용 방식 (TEXT, TEXT_WITH_IMAGES, NUMBER, MATERIALS, COMPONENTS)"},"value":{"type":"string","description":"기본값"},"optionType":{"type":"string","description":"옵션 타입 (RANGE, CANDIDATE, CATEGORY, UNLIMITED, FORMULA)","enum":["RANGE","CANDIDATE","CATEGORY","TEXT_WITH_IMAGES","UNLIMITED","FORMULA"]},"rangeOption":{"$ref":"#/components/schemas/RangeOptionRequest","description":"[RANGE] 범위 옵션"},"candidateOption":{"$ref":"#/components/schemas/CandidateOptionRequest","description":"[CANDIDATE] 후보 값 목록 옵션"},"categoryOption":{"$ref":"#/components/schemas/CategoryOptionRequest","description":"[CATEGORY] 카테고리 옵션"},"unlimitedOption":{"$ref":"#/components/schemas/UnlimitedOptionRequest","description":"[UNLIMITED] 제한 없는 값 목록 옵션"},"formulaOption":{"$ref":"#/components/schemas/FormulaOptionRequest","description":"[FORMULA] 수식 옵션"},"textWithImagesOption":{"$ref":"#/components/schemas/TextWithImagesOptionRequest","description":"[TEXT_WITH_IMAGES] 텍스트+이미지 옵션"}},"required":["usage","value"]},"RangeOptionRequest":{"type":"object","properties":{"min":{"type":"string","description":"최솟값"},"max":{"type":"string","description":"최댓값"},"stepSize":{"type":"string","default":"1","description":"단계 크기"}},"required":["max","min"]},"CandidateOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"후보 값 목록","items":{"type":"string"}}},"required":["values"]},"CategoryOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"카테고리 값 목록","items":{"type":"string"}}},"required":["values"]},"UnlimitedOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"값 목록 (빈 배열로 고정)","items":{"type":"string"}}},"required":["values"]},"FormulaOptionRequest":{"type":"object","properties":{"formulaExpression":{"type":"string","description":"수식 표현식"}},"required":["formulaExpression"]},"TextWithImagesOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"텍스트+이미지 목록","items":{"$ref":"#/components/schemas/TextWithImagesItemRequest"}}},"required":["values"]},"TextWithImagesItemRequest":{"type":"object","properties":{"text":{"type":"string","description":"텍스트"},"imageUrl":{"type":"string","description":"이미지 URL"}},"required":["imageUrl","text"]},"ApiResponseComponentParametersResponse":{"type":"object","properties":{"result":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"data":{"$ref":"#/components/schemas/ComponentParametersResponse","description":"응답 데이터"},"error":{"$ref":"#/components/schemas/ErrorMessage","description":"에러 응답, result FAIL 시 제공"}},"required":["result"]},"ComponentParametersResponse":{"type":"object","properties":{"parameters":{"type":"array","description":"생성된 파라미터 목록","items":{"$ref":"#/components/schemas/ParameterResponse"}}},"required":["parameters"]},"ParameterResponse":{"type":"object","properties":{"id":{"type":"string","description":"파라미터 ID"},"displayName":{"type":"string","description":"표시 이름"},"referenceName":{"type":"string","description":"참조 이름"},"type":{"type":"string","description":"파라미터 타입","enum":["SYSTEM","BASIC","CUSTOM","INTERNAL"]},"valueInfo":{"$ref":"#/components/schemas/ParameterValueInfoResponse","description":"값 정보"},"priority":{"type":"integer","format":"int32","description":"우선순위"},"description":{"type":"string","description":"설명"},"hideCondition":{"type":"string","description":"숨김 조건 표현식"},"enterpriseParameterId":{"type":"string","description":"기업 파라미터 ID"}},"required":["displayName","id","priority","referenceName","type","valueInfo"]},"ParameterValueInfoResponse":{"type":"object","properties":{"usage":{"type":"string","description":"사용 방식"},"value":{"type":"string","description":"현재 값"},"optionType":{"type":"string","description":"옵션 타입","enum":["RANGE","CANDIDATE","CATEGORY","TEXT_WITH_IMAGES","UNLIMITED","FORMULA"]},"options":{"$ref":"#/components/schemas/ParameterOptionsResponse","description":"옵션 값"}},"required":["usage","value"]},"ParameterOptionsResponse":{"type":"object","properties":{"min":{"type":"string","description":"[RANGE] 최솟값"},"max":{"type":"string","description":"[RANGE] 최댓값"},"stepSize":{"type":"string","description":"[RANGE] 단계 크기"},"values":{"type":"array","description":"[CANDIDATE|CATEGORY|UNLIMITED] 값 목록","items":{"type":"string"}},"textWithImagesValues":{"type":"array","description":"[TEXT_WITH_IMAGES] 텍스트+이미지 목록","items":{"$ref":"#/components/schemas/TextWithImagesItemResponse"}},"formulaExpression":{"type":"string","description":"[FORMULA] 수식 표현식"}}},"TextWithImagesItemResponse":{"type":"object","properties":{"text":{"type":"string","description":"텍스트"},"imageUrl":{"type":"string","description":"이미지 URL"}},"required":["imageUrl","text"]},"ErrorMessage":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INTERNAL_ERROR","BAD_REQUEST","NOT_FOUND","CONFLICT","FORBIDDEN"]},"message":{"type":"string","description":"에러 메시지"}}}}},"paths":{"/api/v1/parametric/components/{componentId}/parameters":{"post":{"tags":["파라메트릭"],"summary":"컴포넌트 파라미터 생성","description":"파라메트릭 컴포넌트에 파라미터를 생성한다.","operationId":"createComponentParameters","parameters":[{"name":"componentId","in":"path","description":"컴포넌트 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"생성할 파라미터 목록","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComponentParametersCreateRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseComponentParametersResponse"}}}}}}}}}
```

## 파라미터 정보 수정

> 파라미터 정보를 수정한다.

```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":{"ModifyParameterRequest":{"type":"object","properties":{"displayName":{"type":"string","description":"표시 이름"},"referenceName":{"type":"string","description":"참조 이름"},"type":{"type":"string","description":"파라미터 타입","enum":["SYSTEM","BASIC","CUSTOM","INTERNAL"]},"valueInfo":{"$ref":"#/components/schemas/ParameterValueInfoRequest","description":"값 정보"},"priority":{"type":"integer","format":"int32","description":"우선순위"},"description":{"type":"string","description":"설명"},"hideCondition":{"type":"string","description":"숨김 조건 표현식"},"enterpriseParameterId":{"type":"string","description":"기업 파라미터 ID"}},"required":["displayName","priority","referenceName","type","valueInfo"]},"ParameterValueInfoRequest":{"type":"object","properties":{"usage":{"type":"string","description":"사용 방식 (TEXT, TEXT_WITH_IMAGES, NUMBER, MATERIALS, COMPONENTS)"},"value":{"type":"string","description":"기본값"},"optionType":{"type":"string","description":"옵션 타입 (RANGE, CANDIDATE, CATEGORY, UNLIMITED, FORMULA)","enum":["RANGE","CANDIDATE","CATEGORY","TEXT_WITH_IMAGES","UNLIMITED","FORMULA"]},"rangeOption":{"$ref":"#/components/schemas/RangeOptionRequest","description":"[RANGE] 범위 옵션"},"candidateOption":{"$ref":"#/components/schemas/CandidateOptionRequest","description":"[CANDIDATE] 후보 값 목록 옵션"},"categoryOption":{"$ref":"#/components/schemas/CategoryOptionRequest","description":"[CATEGORY] 카테고리 옵션"},"unlimitedOption":{"$ref":"#/components/schemas/UnlimitedOptionRequest","description":"[UNLIMITED] 제한 없는 값 목록 옵션"},"formulaOption":{"$ref":"#/components/schemas/FormulaOptionRequest","description":"[FORMULA] 수식 옵션"},"textWithImagesOption":{"$ref":"#/components/schemas/TextWithImagesOptionRequest","description":"[TEXT_WITH_IMAGES] 텍스트+이미지 옵션"}},"required":["usage","value"]},"RangeOptionRequest":{"type":"object","properties":{"min":{"type":"string","description":"최솟값"},"max":{"type":"string","description":"최댓값"},"stepSize":{"type":"string","default":"1","description":"단계 크기"}},"required":["max","min"]},"CandidateOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"후보 값 목록","items":{"type":"string"}}},"required":["values"]},"CategoryOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"카테고리 값 목록","items":{"type":"string"}}},"required":["values"]},"UnlimitedOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"값 목록 (빈 배열로 고정)","items":{"type":"string"}}},"required":["values"]},"FormulaOptionRequest":{"type":"object","properties":{"formulaExpression":{"type":"string","description":"수식 표현식"}},"required":["formulaExpression"]},"TextWithImagesOptionRequest":{"type":"object","properties":{"values":{"type":"array","description":"텍스트+이미지 목록","items":{"$ref":"#/components/schemas/TextWithImagesItemRequest"}}},"required":["values"]},"TextWithImagesItemRequest":{"type":"object","properties":{"text":{"type":"string","description":"텍스트"},"imageUrl":{"type":"string","description":"이미지 URL"}},"required":["imageUrl","text"]},"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/parametric/components/parameters/{parameterId}":{"post":{"tags":["파라메트릭"],"summary":"파라미터 정보 수정","description":"파라미터 정보를 수정한다.","operationId":"modifyParameterInfo","parameters":[{"name":"parameterId","in":"path","description":"파라미터 ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"수정할 파라미터 정보","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModifyParameterRequest"}}},"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":{"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/parametric/components/parameters/{parameterId}":{"delete":{"tags":["파라메트릭"],"summary":"파라미터 단건 삭제","description":"파라미터를 단건 삭제한다.","operationId":"deleteParameter","parameters":[{"name":"parameterId","in":"path","description":"파라미터 ID","required":true,"schema":{"type":"string"}}],"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":{"DeleteParametersRequest":{"type":"object","properties":{"parameterIds":{"type":"array","description":"삭제할 파라미터 ID 목록","items":{"type":"string"}}},"required":["parameterIds"]},"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/parametric/components/parameters":{"delete":{"tags":["파라메트릭"],"summary":"파라미터 다건 삭제","description":"파라미터를 다건 삭제한다.","operationId":"deleteParameters","requestBody":{"description":"삭제할 파라미터 ID 목록","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteParametersRequest"}}},"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-10.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.