---
title: "이미지 조회"
method: GET
path: "/api/v1/images/{id}"
tags: ["이미지"]
---

# 이미지 조회

`GET /api/v1/images/{id}`

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

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

### CDN Query Parameter
- `w` : 가로 픽셀. `h`가 주어지면 같은 비율로 축소. 둘 다 없으면 원본 사이즈 사용.
- `h` : 세로 픽셀. `w`가 주어지면 같은 비율로 축소. 둘 다 없으면 원본 사이즈 사용.
- `f` : 출력 포맷. `jpeg`, `jpg`, `png`, `webp` 없으면: 원본 포맷.
- `q` : 압축 퀄리티. 기본값: `85`

## Path parameters

- `id` string, required

## Response `200`

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

- ApiResponseImageDetail
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` ImageDetail
    - `id` string, required — 이미지 ID
    - `userId` string, required — 사용자 ID
    - `name` string, required — 이미지 이름
    - `type` 'RENDER' | 'TOP_VIEW' | 'PANORAMA' | 'TOUR_720', required — 이미지 유형
    - `imageUrl` string, required — 이미지 URL
    - `floorplanId` string — 도면 ID
    - `resolution` ResolutionResponse, required
      - `x` integer, required — 가로 해상도
      - `y` integer, required — 세로 해상도
    - `items` ImageItemResponse[] — 이미지 아이템 목록
      - `productId` string, required — 상품 ID
      - `position` PositionResponse, required
        - `x` number, double, required — X 좌표
        - `y` number, double, required — Y 좌표
        - `z` number, double, required — Z 좌표
    - `roomCode` integer, required — 방 코드
    - `panoramaImageIds` string[] — 파노라마 이미지 ID 목록
    - `status` 'CREATING' | 'WAITING' | 'IN_PROCESSING' | 'COMPLETED' | 'FAILED', required — 이미지 상태
    - `estimatedEndTime` string, date-time, required — 예상 완료 시각
    - `createdAt` string, date-time, required — 생성일시
    - `updatedAt` string, date-time, required — 수정일시
  - `error` ErrorMessage
    - `errorCode` 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN' — 에러 코드
    - `message` string — 에러 메시지

---

[API](https://skmtc.dev/archisketch/apis/open-api.md) · [All operations](https://skmtc.dev/archisketch/apis/open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archisketch/open-api/revisions/f6b0eda1a99d/schema)