카테고리

최상위 카테고리(디렉토리) 조회

get

유형별 최상위(ROOT) 카테고리를 조회합니다.

유형

• FURNITURE : 가구

• FURNITURE_SET : 가구 세트

• FINISH : 재질

• TEXTURE : 질감

• PROJECT : 프로젝트

• USER : 사용자

• COMPONENT : 부품

• PARAMETRIC_SALE : 파라메트릭 상품

• FILE : 파일

Authorizations

x-api-keystringRequired

Query parameters

categoryTypestring · enumRequired

카테고리 타입

Possible values:

Responses

200

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

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

get/api/v1/categories

GET /api/v1/categories?categoryType=FURNITURE HTTP/1.1
Host: openapi.archisketch.com
x-api-key: YOUR_API_KEY
Accept: */*

200

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

{
  "result": "SUCCESS",
  "data": {
    "id": "text",
    "parentId": "text",
    "name": "text",
    "image": "text",
    "childCategories": [
      {
        "id": "text",
        "name": "text",
        "image": "text",
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-01-01T00:00:00.000Z"
      }
    ],
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}

카테고리 조회

get

카테고리 ID를 이용하여 카테고리 정보와 하위 카테고리 목록을 조회합니다.

사용처

• 특정 카테고리의 상세 정보 조회

• 하위 카테고리 목록 확인

• 카테고리 계층 구조 탐색

Authorizations

x-api-keystringRequired

Path parameters

idstringRequired

카테고리 ID

Responses

200

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

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

get/api/v1/categories/{id}

GET /api/v1/categories/{id} HTTP/1.1
Host: openapi.archisketch.com
x-api-key: YOUR_API_KEY
Accept: */*

200

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

{
  "result": "SUCCESS",
  "data": {
    "id": "text",
    "parentId": "text",
    "name": "text",
    "image": "text",
    "childCategories": [
      {
        "id": "text",
        "name": "text",
        "image": "text",
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-01-01T00:00:00.000Z"
      }
    ],
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}