문서
Simplio3D을 구축하고, 통합하고, 확장하세요
여기에서 3D 제품 컨피규레이터를 제대로 구축하는 데 필요한 모든 정보를 확인할 수 있습니다.
참조 문서 3개
에디터에서 구축하기 위한 튜토리얼과 헤드리스 방식으로 구축하기 위한 API 및 SDK입니다.
튜토리얼에서 다루는 내용
문서는 기능명이 아닌 작업 목적에 따라 구성되어 있습니다.
| 섹션 | 다루는 내용 |
|---|---|
| 에셋 | 3D 모델, 텍스처 및 그래픽 업로드, 그리고 기존 구성을 유지한 채 모델을 새 버전으로 교체하는 방법 |
| 재질 | PBR 재질 생성, 공유 재질 라이브러리, 올바른 UV 방향으로 텍스처 적용, 카테고리별 일괄 추가 |
| 프로젝트 | 프로젝트 유형, 에디터 인터페이스, 객체 및 옵션 모드, 조건부 로직, 가격 책정, 양식, 설정, 공유 및 AR |
| AI | AI로 구성기 만들기, 어시스턴트 및 에이전트 워크플로, 다단계 AI 작업 관리 |
| 통합 | WooCommerce, Shopify, REST API 및 TypeScript SDK, MCP 연결, 모바일 및 네이티브 앱, 맞춤형 UI 구축 |
| 요청 및 계정 | 견적 및 양식 제출 검토, 체험 및 청구 관리, 팀원 관리 |
헤드리스 방식으로 구축하기
스토어프론트가 맞춤형이라면, 이 요소들이 중요합니다.
인증
X-API-Key 헤더의 API 토큰은 옵션 블록, 가격, 견적 제출 및 웹훅을 처리합니다. Bearer 자격 증명으로 사용하는 액세스 토큰은 전체 기능에 접근할 수 있게 합니다. 두 가지 모두 서버 측에서 유지하세요.
타입이 지정된 클라이언트 사용하기
@simplio3d/sdk는 동일한 REST API을 위한 타입이 지정된 클라이언트입니다. 프로젝트 데이터를 헤드리스 방식으로 관리하며, 컨피규레이터를 렌더링하지 않고 뷰어나 3D 캔버스도 포함하지 않습니다.
에이전트 연결
MCP 서버는 OAuth 2.1 또는 범위가 지정된 Bearer 토큰을 통해 115개의 도구(읽기 전용 51개 및 제어된 쓰기 61개)를 제공하며, 제안·확인·스냅샷 쓰기 모델을 사용합니다.
모든 것이 블록입니다
이 플랫폼은 하나의 아이디어를 기반으로 구축되었습니다. 옵션, 규칙, 가격은 모두 속성을 지닌 블록이며, 코드를 작성하는 대신 시각적으로 조합됩니다. 16가지 옵션 블록 유형은 고객의 상호작용 방식을 포괄하고, 6가지 가격 블록 유형은 토큰 기반 수식 편집기에서 결합됩니다. 이러한 아키텍처 덕분에 두 번째 제품은 새로운 개발 프로젝트가 아니라 조립 방식으로 구현됩니다.