RealityConnect API (RCAPI)

소개 Prevu3D RealityConnect API 개요: 기능, 지역별 아키텍처, OAuth2 인증, 그리고 RealityPlatform 및 RealityTwin 연동에 어떻게 부합하는지.

시작하기 RealityConnect API의 전제 조건, 네트워크 접근, 보안 모델. OAuth 플로를 선택하고 전용 가이드를 따르세요.

처음부터 끝까지, 첫 번째 변경 복사해서 바로 쓰는 Client Credentials 실습: 토큰을 받고, 사이트로 이동해 이름을 변경하고, Prevu3D Platform에서 변경 사항을 확인한 뒤 되돌립니다.

OAuth 스코프 참조 RealityConnect API가 부여하는 모든 OAuth 스코프와 그 권한, 신규 연동에서 흔히 놓치는 주의 사항을 안내합니다.

Business Object 및 노드 검색 RealityConnect API를 통해 트윈 내부의 business object와 메타데이터를 검색하거나, 조직의 노드 계층 구조를 검색합니다.

OAuth 흐름 Client Credentials 플로, Native Application 플로 및 Authorization Code + Custom Redirect 플로

속도 제한 RealityConnect API의 속도 제한 버킷, 응답 헤더, 429 Too Many Requests 처리 방법을 설명합니다.

오류 코드 RealityConnect API 작업이 반환하는 명명된 오류 코드에 대한 참조로, 엔드포인트별로 정리되어 있으며 각각의 응답 형식과 권장 처리 방법을 포함합니다.

contextId가 허용하는 값 RealityConnect API의 twin 및 RealityPlan 라우트에서 경로 매개변수 contextId가 허용하는 id 유형과, 유효한 id에도 404가 발생하는 이유를 설명합니다.

실전 토큰 라이프사이클 장기 실행 연동에서 RealityConnect API OAuth 토큰을 안전하게 캐시하고 갱신하는 방법. 플로별 실제 TTL과 토큰이 조기에 무효화되는 요인을 다룹니다.

자격 증명 관리 RealityConnect API OAuth 자격 증명을 안전하게 저장, 교체, 폐기하는 방법과 유출된 액세스 토큰이 도달할 수 있는 범위.

리소스별로 실제 삭제가 하는 일 RealityConnect API의 각 리소스를 삭제할 때 실제로 무슨 일이 일어나는지에 대한 참조: 어떤 삭제가 복구 가능한지, 무엇이 삭제를 막는지, 남겨진 참조는 어떻게 되는지.

노드 유형 및 계층 구조 RealityConnect API의 10가지 노드 유형, 유효한 부모/자식 조합, API가 생성할 수 있는 유형, DataNode 구조를 설명합니다.

API 안정성, 버전 관리 및 지원 중단 RealityConnect API가 실험적 작업을 표시하는 방법, 호환성이 깨지는 변경의 기준, 그리고 폐기 정책을 설명합니다.

POI 아이콘 참조(textureId) 관심 지점(POI)을 생성할 때 사용할 수 있는 전체 textureId 값과 각 아이콘이 실제로 나타내는 모습입니다.

ID 찾기: 조직, 노드, 컨텍스트 조직 ID를 확인하고 RealityConnect API의 노드 트리를 탐색하며, 각 라우트 계열이 요구하는 ID(contextId, organizationId)를 알아봅니다.

공유 멀티파트 업로드 참조 RealityConnect API 업로드 엔드포인트가 공유하는 개시, 업로드, 마무리 패턴과 partNumber 대 startIndex 파트 번호 규칙을 설명합니다.

타입이 지정된 메타데이터 값과 첨부 파일 RealityConnect API 메타데이터 속성 값 참조: string/number/boolean/태그된 객체 유니언, external-link 및 attachment 센티널 타입, 첨부 파일 업로드·다운로드·삭제 흐름.

노드 썸네일 데이터 노드의 썸네일 이미지를 업로드, 조회, 삭제하는 방법과 browse 및 search에서 includeThumbnail과 thumbnailSignedUrl이 동작하는 방식.

네트워크 요구 사항 기업 네트워크에서 RealityConnect API에 연결하기 위한 방화벽, 프록시, TLS, 아웃바운드(egress) 요구 사항과 단계별 연결 진단 방법을 안내합니다.

RealityConnect API FAQ 프로젝트가 승인되기도 전에 나오는, RealityConnect API에 관한 상업적·아키텍처적 '이거 할 수 있나요' 질문에 대한 답변 모음입니다.