ドキュメント
Simplio3D を構築、統合、拡張
ここでは、3D製品コンフィギュレーターを適切に構築するために必要なすべての情報をご覧いただけます。
3つのリファレンス
エディターで構築するためのチュートリアル、ならびにヘッドレス構築向けのAPIとSDK。
API リファレンス
Simplio RESTful APIを使用して、強力なヘッドレス3D CPQアプリケーションを構築できます。オプションブロック、条件ロジック、価格設定、お問い合わせフォーム、3Dビューア、アニメーションなどを完全に制御できます。
API リファレンスSDK リファレンス
Simplio 3D CPQ プラットフォーム向けの公式 TypeScript SDK。オプションブロック、条件付きロジック、価格計算式、お問い合わせフォーム、3Dビューア、アニメーションなどを完全にヘッドレスでサポートします。
SDK リファレンスチュートリアルで学べる内容
ドキュメントは機能名ではなく、実行したい作業ごとに整理されています。
| セクション | 対象内容 |
|---|---|
| アセット | 3Dモデル、テクスチャ、グラフィックのアップロード。モデルを新しいバージョンに置き換えつつ、そのモデルを基に構築された設定を保持します。 |
| マテリアル | PBRマテリアルの作成、共有マテリアルライブラリ、正しいUV方向でのテクスチャ適用、カテゴリ別の一括追加 |
| プロジェクト | プロジェクトの種類、エディターインターフェース、オブジェクトモードとオプションモード、条件ロジック、価格設定、フォーム、設定、共有、そしてAR |
| AI | AIを活用したコンフィギュレーターの構築、アシスタントおよびエージェントのワークフロー、複数ステップのAIジョブ管理 |
| 連携 | WooCommerce、Shopify、REST APIとTypeScript SDK、MCP接続、モバイルアプリとネイティブアプリ、カスタムUIの構築 |
| リクエストとアカウント | 見積もり・フォーム送信の確認、トライアルと請求の管理、チームメンバーの管理 |
ヘッドレスで構築する
ストアフロントがカスタムの場合、重要なのは以下の要素です。
認証
X-API-Key ヘッダー内の API トークンで、オプションブロック、価格設定、見積もり送信、Webhookを利用できます。Bearer 認証情報としてのアクセストークンを使用すると、すべての機能にアクセスできます。どちらもサーバー側で管理してください。
型付きクライアントを使用する
@simplio3d/sdk は、同じ REST API 用の型付きクライアントです。プロジェクトデータをヘッドレスで管理します。コンフィギュレーターをレンダリングするものではなく、ビューアーや 3D キャンバスも含まれていません。
エージェントを接続
MCPサーバーは、OAuth 2.1またはスコープ付きベアラートークンを通じて、123のツール（読み取り専用52件、制御付き書き込み68件、ワークフロー3件）を提供します。書き込みモデルには、提案、確認、スナップショットが採用されています。
すべてがブロックです
このプラットフォームは、オプション、ルール、価格をすべて属性を持つブロックとして扱い、コードを書くのではなく視覚的に組み立てるという考え方に基づいています。16種類のオプションブロックが顧客とのインタラクションをカバーし、基本価格から数量別価格、割引、税までの価格ブロックは、トークンベースの数式エディターで組み合わせられます。 このアーキテクチャにより、2つ目の製品も新規開発プロジェクトではなく、組み立てによって実現できます。