이력 조회

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

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

사전 단계

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

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

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

2. Secret Key 발급

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

요청

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

요청 헤더

ARC eye API에서 공통으로 사용하는 헤더에 대한 정보는 ARC eye 요청 헤더를 참조해 주십시오.

요청 경로 변수

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

요청 쿼리 파라미터

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

요청 예시

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

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

응답

응답 형식을 설명합니다.

응답 바디(성공)

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

versions

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

응답 예시

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

성공

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

{
  "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"
    }
  ]
}