RealityConnect API FAQ
어떤 질문은 특정 레퍼런스 페이지에 속하지 않습니다. 상업적이거나 아키텍처적인 질문, 또는 API가 하지 않는 것에 관한 질문입니다. 이 페이지는 코드를 한 줄도 작성하기 전에 지원, 솔루션 엔지니어링, 영업 대화에서 가장 자주 나오는 질문들을 모아둔 것입니다.
하나의 자격 증명 세트로 둘 이상의 조직에 접근할 수 있나요?
섹션 제목: “하나의 자격 증명 세트로 둘 이상의 조직에 접근할 수 있나요?”아니요, 설계상 그렇습니다. 각 OAuth 토큰은 발급된 조직에 영구적으로 스코프가 지정되어 있으며, 하나의 자격 증명 세트로 조직을 전환하거나 여러 조직에 걸쳐 읽을 방법은 없습니다. API가 할 수 있는 것과 할 수 없는 것의 전체 그림은 소개와 기능 개요를 참조하세요.
토큰에 모든 스코프가 있는데 왜 목록이 비어 있나요?
섹션 제목: “토큰에 모든 스코프가 있는데 왜 목록이 비어 있나요?”스코프가 아니라 콘텐츠 접근과 역할을 확인하세요. OAuth 스코프는 보안 모델의 계층 1에 불과하므로, 모든 스코프를 가진 토큰이라도 호출 계정이 콘텐츠 접근 권한을 가진 노드만 볼 수 있고, 그 노드에서 할당된 역할 범위 내에서만 작업할 수 있습니다. 결과가 비어 있는 것은 거의 항상 계층 2나 3의 문제이지, 스코프 누락이 아닙니다. 작업별 OAuth 스코프에서 애초에 올바른 스코프를 가지고 있는지 확인한 다음, 해당 노드에서 호출 계정의 콘텐츠 접근과 역할을 확인하세요.
조직의 지역은 어떻게 확인하나요?
섹션 제목: “조직의 지역은 어떻게 확인하나요?”액세스 토큰으로 GET /oauth/api-info를 호출하세요. 응답에 지역별 apiUrl과 organization.id가 포함됩니다. 지역 URL을 절대 하드코딩하지 마세요. 실제 예시는 시작하기와 Client Credentials 플로를 참조하세요.
RealityTwin 라이선스나 RealityPlan 시트 없이 API를 사용할 수 있나요?
섹션 제목: “RealityTwin 라이선스나 RealityPlan 시트 없이 API를 사용할 수 있나요?”대부분의 경우 가능합니다. RealityTwin Data Manager 라이선스는 twin 콘텐츠와 관련된 호출(애셋, POI, 존, 드래프트, 검색, 객체 메타데이터, 임베드 세션, 애셋 라이브러리)에서만 소모됩니다. 사용자·초대 관리, 역할, 그리고 검색용 /oauth/api-info 호출은 twin과 무관하며 라이선스를 소모하지 않습니다. 일부 RealityPlan 관련 엔드포인트는 RealityPlan 시트도 소모합니다. 라이선스를 참조하세요.
테스트 또는 샌드박스 환경이 있나요?
섹션 제목: “테스트 또는 샌드박스 환경이 있나요?”현재 전용 샌드박스나 체험 환경은 없습니다. API를 사용해 보는 가장 간단한 방법은 자신의 조직 안에 Client Credentials 애플리케이션을 만드는 것입니다. OAuth 플로 선택을 참조하세요.
우리 시스템의 식별자를 Prevu3D 객체에 어떻게 유지하나요?
섹션 제목: “우리 시스템의 식별자를 Prevu3D 객체에 어떻게 유지하나요?”이를 위한 전용 필드는 없습니다. 객체의 메타데이터에 일반 문자열이나 숫자 속성을 사용하세요. 예를 들어 “External IDs”라는 섹션에 자사 시스템의 식별자를 담는 식입니다. 메타데이터는 고정된 스키마가 아니라 자유 형식의 키/값 데이터이므로, 미리 아무것도 프로비저닝하지 않아도 어떤 속성 이름이든 사용할 수 있습니다. 타입이 지정된 메타데이터 값과 첨부 파일을 참조하세요.