이미지

이미지 조회

get

이미지 ID를 이용하여 이미지 정보를 조회합니다.

imageUrl은 CDN에서 제공되며, 아래 Query Parameter로 이미지 옵션을 지정할 수 있습니다.

CDN Query Parameter

• w : 가로 픽셀. h가 주어지면 같은 비율로 축소. 둘 다 없으면 원본 사이즈 사용.

• h : 세로 픽셀. w가 주어지면 같은 비율로 축소. 둘 다 없으면 원본 사이즈 사용.

• f : 출력 포맷. jpeg, jpg, png, webp 없으면: 원본 포맷.

• q : 압축 퀄리티. 기본값: 85

Authorizations

open-api-key

x-api-keystringRequired

Path parameters

idstringRequired

이미지 ID

Responses

200

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

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

get

/api/v1/images/{id}

HTTPcURLJavaScriptPython

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

200

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

{
  "result": "SUCCESS",
  "data": {
    "id": "text",
    "userId": "text",
    "name": "text",
    "type": "RENDER",
    "imageUrl": "text",
    "floorplanId": "text",
    "resolution": {
      "x": 1,
      "y": 1
    },
    "items": [
      {
        "productId": "text",
        "position": {
          "x": 1,
          "y": 1,
          "z": 1
        }
      }
    ],
    "roomCode": 1,
    "panoramaImageIds": [
      "text"
    ],
    "status": "CREATING",
    "estimatedEndTime": "2026-05-21T00:08:02.251Z",
    "createdAt": "2026-05-21T00:08:02.251Z",
    "updatedAt": "2026-05-21T00:08:02.251Z"
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}