API

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

AR·로봇·스마트 빌딩 등에 활용할 수 있는 측위 API를 배포하여 운영 및 관리할 수 있습니다.

API 화면

API 메뉴에 접속하려면 네이버 클라우드 플랫폼 콘솔에서 Services > Digital Twin > ARC eye > API 메뉴를 차례대로 클릭해 주십시오. API 화면은 다음과 같이 구성되어 있습니다.

API 서비스 운영

SLAM 데이터를 VL 데이터로 변환하면 이미지 인식 값을 요청할 수 있는 API 데이터가 생성되며, 이 API 데이터를 배포하여 서비스할 수 있습니다. API 서비스를 운영하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Digital Twin > ARC eye 메뉴를 차례대로 클릭해 주십시오.
2. API 메뉴를 클릭해 주십시오.
3. 프로젝트 이름 드롭다운 목록에서 원하는 프로젝트를 선택해 주십시오.
4. API 목록이 표시되면 필요에 따라 다음 작업을 진행해 주십시오.
   • API 연동 키 생성 및 Invoke URL 확인
   • API 서비스 시작(배포)
   • API 서비스 중지

API 연동 키 생성 및 Invoke URL 확인

API 서비스의 사용 권한이 있는 사용자만 API에 접근하여 API를 호출할 수 있도록 API 연동 키(secret key)를 먼저 생성해야 합니다. Invoke URL은 생성한 API 데이터를 응답 받을 수 있도록 호출하는 주소(endpoint)입니다. 앱 개발자 등의 API 사용자는 API 연동 키 + Invoke URL을 사용해 API를 호출해야 합니다. API 연동 키를 생성하고, 확인하는 방법은 다음과 같습니다.

1. [API 연동 키 확인] 버튼을 클릭해 주십시오.
2. API 연동 키 확인 팝업 창에서 Secret Key 항목에 있는 [생성] 버튼을 클릭해 주십시오.
   • 항목 필드에 API 연동 키가 생성됩니다.
   • 생성한 API 연동 키를 클립보드에 복사하려면 [복사] 버튼을 클릭해 주십시오.
3. Invoke URL에서 Invoke URL을 확인해 주십시오.
   • Invoke URL은 해당 프로젝트 생성 시 자동으로 생성됩니다.
   • Invoke URL을 클립보드에 복사하려면 [주소 복사] 버튼을 클릭해 주십시오.

API 서비스 시작(배포)

API를 배포하려면 목록에서 API를 클릭하여 선택한 후 [배포] 버튼을 클릭해 주십시오.

• 최초 배포의 경우에는 목록의 배포 상태가 대기에서 완료으로 변경되고, [API 서비스 중지] 버튼이 활성화됩니다.
• 중지된 API를 재배포하는 경우에는 목록의 배포 상태가 중단에서 완료로 변경되고, [API 서비스 중지] 버튼이 활성화됩니다.
• 프로젝트당 1개의 API를 배포할 수 있습니다. 여러 버전의 API를 가진 프로젝트에서 대기 또는 중지 상태인 API를 배포하면, 현재 배포 중인 API는 자동으로 서비스 중지 상태가 됩니다.

API 서비스 중지

서비스 중인 API를 서비스 중지하려면 목록에서 API를 클릭하여 선택한 후 [API 서비스 중지] 버튼을 클릭해 주십시오.

• API 서비스가 중지되면 목록의 배포 상태가 완료에서 중단으로 변경되고, [배포] 버튼이 활성화됩니다.
• API 서비스를 재배포하려면 목록에서 API를 선택한 후 [배포] 버튼을 클릭해 주십시오.

API 삭제

API를 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Digital Twin > ARC eye 메뉴를 차례대로 클릭해 주십시오.
2. API 메뉴를 클릭해 주십시오.
3. 프로젝트 이름 드롭다운 목록에서 원하는 프로젝트를 선택해 주십시오.
4. 삭제할 API가 API 배포 중인 경우 API를 클릭하여 선택한 후 [API 서비스 중지] 버튼을 클릭해 API 배포를 중지해 주십시오.
5. 삭제할 API를 클릭하여 선택한 후 [선택 삭제] 버튼을 클릭해 주십시오.
6. API 삭제 팝업 창이 나타나면 [삭제] 버튼을 클릭해 주십시오.