모델링

모델링 생성

post

파일을 업로드하여 모델링을 생성한다.

Authorizations

open-api-key

x-api-keystringRequired

Query parameters

isPersonalbooleanOptional

개인 라이브러리 여부

startModelingbooleanOptional

즉시 렌더링 시작 여부

Body

multipart/form-data

namestringRequired

모델링 이름

filestring · binaryRequired

모델링 파일

Responses

200

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

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

post/api/v1/modelings

HTTPcURLJavaScriptPython

POST /api/v1/modelings HTTP/1.1
Host: openapi.archisketch.com
x-api-key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 31

{
  "name": "text",
  "file": "binary"
}

200

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

{
  "result": "SUCCESS",
  "data": {
    "id": "text",
    "name": "text",
    "enterpriseId": "text",
    "userId": "text",
    "renderingStatus": "WAITING",
    "renderingStartedAt": "2026-07-12T16:09:18.611Z",
    "renderingFinishedAt": "2026-07-12T16:09:18.611Z",
    "renderingFailedAt": "2026-07-12T16:09:18.611Z",
    "dimension": {
      "mmWidth": 1,
      "mmDepth": 1,
      "mmHeight": 1,
      "inchWidth": 1,
      "inchDepth": 1,
      "inchHeight": 1
    },
    "images": [
      {
        "id": "text",
        "name": "text",
        "url": "text"
      }
    ],
    "file": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "editorAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "renderAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "decimateAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "createdAt": "2026-07-12T16:09:18.611Z",
    "updatedAt": "2026-07-12T16:09:18.611Z"
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}

모델링 파일 변경

patch

모델링의 원본 파일을 변경한다.

Authorizations

open-api-key

x-api-keystringRequired

Path parameters

idstringRequired

모델링 ID

Query parameters

startModelingbooleanOptional

즉시 렌더링 시작 여부

Body

multipart/form-data

filestring · binaryRequired

새 모델링 파일

Responses

200

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

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

patch/api/v1/modelings/{id}/file

HTTPcURLJavaScriptPython

PATCH /api/v1/modelings/{id}/file HTTP/1.1
Host: openapi.archisketch.com
x-api-key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

200

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

{
  "result": "SUCCESS",
  "data": {
    "id": "text",
    "name": "text",
    "enterpriseId": "text",
    "userId": "text",
    "renderingStatus": "WAITING",
    "renderingStartedAt": "2026-07-12T16:09:18.611Z",
    "renderingFinishedAt": "2026-07-12T16:09:18.611Z",
    "renderingFailedAt": "2026-07-12T16:09:18.611Z",
    "dimension": {
      "mmWidth": 1,
      "mmDepth": 1,
      "mmHeight": 1,
      "inchWidth": 1,
      "inchDepth": 1,
      "inchHeight": 1
    },
    "images": [
      {
        "id": "text",
        "name": "text",
        "url": "text"
      }
    ],
    "file": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "editorAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "renderAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "decimateAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "createdAt": "2026-07-12T16:09:18.611Z",
    "updatedAt": "2026-07-12T16:09:18.611Z"
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}

모델링 조회

get

Authorizations

open-api-key

x-api-keystringRequired

Path parameters

idstringRequired

모델링 ID

Responses

200

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

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

get/api/v1/modelings/{id}

HTTPcURLJavaScriptPython

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

200

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

{
  "result": "SUCCESS",
  "data": {
    "id": "text",
    "name": "text",
    "enterpriseId": "text",
    "userId": "text",
    "renderingStatus": "WAITING",
    "renderingStartedAt": "2026-07-12T16:09:18.611Z",
    "renderingFinishedAt": "2026-07-12T16:09:18.611Z",
    "renderingFailedAt": "2026-07-12T16:09:18.611Z",
    "dimension": {
      "mmWidth": 1,
      "mmDepth": 1,
      "mmHeight": 1,
      "inchWidth": 1,
      "inchDepth": 1,
      "inchHeight": 1
    },
    "images": [
      {
        "id": "text",
        "name": "text",
        "url": "text"
      }
    ],
    "file": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "editorAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "renderAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "decimateAsset": {
      "id": "text",
      "name": "text",
      "url": "text"
    },
    "createdAt": "2026-07-12T16:09:18.611Z",
    "updatedAt": "2026-07-12T16:09:18.611Z"
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}