---
title: "이력 조회"
slug: "arc-eye-mapdata-versions-api"
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/arc-eye-mapdata-versions-api"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 이력 조회

Classic/VPC 환경에서 이용 가능합니다.

특정 로케이션의 e-map 또는 로봇맵 변환 이력(버전) 목록을 조회합니다. 동일 로케이션에 대해 변환 작업이 여러 번 수행된 경우, 각 성공 이력이 버전으로 누적됩니다. 응답은 버전 번호 기준 내림차순으로 정렬되어 반환됩니다.

## 사전 단계

Map Data - 이력 조회 API를 사용하기 위한 사전 단계는 다음과 같습니다.

### 1. e-map 생성 또는 로봇맵 생성

콘솔에서 대상 최상위 로케이션에 대해 e-map 생성 또는 로봇맵 생성 작업을 수행하고 **성공** 상태까지 완료해 주십시오. 자세한 진행 방법은 [ARC eye 사용 가이드](https://guide.ncloud-docs.com/docs/arceye-mapdata)를 참조해 주십시오.

### 2. Secret Key 발급

네이버 클라우드 플랫폼 콘솔의 **Menu** > **All Services** > **Digital Twin** > **ARC eye** > **Visual Localization** > **Data Management** 메뉴에서 대상 Emapper 또는 RobotMap 작업 상세의 **Secret Key**의 **[생성]** 버튼을 클릭하여 Map Data 전용 Secret Key를 발급받아 주십시오. 자세한 방법은 [ARC eye 사용 가이드](https://guide.ncloud-docs.com/docs/arceye-mapdata)를 참조해 주십시오.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /map-data/v1/{projectId}/{signature}/{task}/versions |

참고

[ARC eye 공통 설정 > API URL](/docs/arc-eye-overview#APIURL)의 다운로드 URL 조회 API URL의 마지막 경로 `/download-urls`를 `/versions`로 치환하여 호출합니다.

### 요청 헤더

ARC eye API에서 공통으로 사용하는 헤더에 대한 정보는 [ARC eye 요청 헤더](/docs/arc-eye-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 경로 변수

요청 경로 변수에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `projectId` | Number | Required | 프로젝트 ID - 다운로드 URL 조회 화면에서 조회 가능 |
| `signature` | String | Required | 프로젝트 서명 값 - 다운로드 URL 조회 화면에서 조회 가능 |
| `task` | String | Required | 조회 대상 Task 종류 - `emapper` \| `robot-map` - 다운로드 URL 조회 화면에서 조회 가능 |

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `locationId` | Number | Required | 대상 로케이션 ID - [Map Data - 로케이션 조회](/docs/arc-eye-mapdata-locations-api) 응답의 `locationId` |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET '{InvokeURL}?locationId=2001' \
--header 'X-ARCEYE-SECRET: {SecretKey}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디(성공)

조회가 성공한 경우의 응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `versions` | Array | - | 해당 로케이션의 변환 버전 목록 - 버전 번호 내림차순 정렬 : [versions](/docs/arc-eye-mapdata-versions-api#versions) |

#### `versions`

`versions`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `version` | Number | - | 버전 번호 - 값이 클수록 최신 버전 |
| `createdAt` | String | - | 해당 버전 생성 일시 |

### 응답 예시

응답 예시는 다음과 같습니다.

#### 성공

조회가 성공한 경우의 응답 예시는 다음과 같습니다.

```
{
  "versions": [
    {
      "version": 3,
      "createdAt": "2026-04-21 16:57:58"
    },
    {
      "version": 2,
      "createdAt": "2026-04-20 12:35:25"
    },
    {
      "version": 1,
      "createdAt": "2026-04-17 11:55:48"
    }
  ]
}
```

참고

API 호출이 실패한 경우의 응답 바디와 응답 예시는 [ARC eye 개요](/docs/arc-eye-overview#%EC%9D%91%EB%8B%B5)를 참조해 주십시오.