ドキュメント
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 またはスコープ付きベアラートークンを介して、115 種類のツール（読み取り専用 51 種類、制御された書き込み 61 種類）を公開し、提案・確認・スナップショットによる書き込みモデルを採用しています。
すべてがブロックです
このプラットフォームは、オプション、ルール、価格のすべてを属性を持つブロックとして扱い、コードを書くのではなく視覚的に組み立てるという一つの考え方に基づいて構築されています。16種類のオプションブロックが顧客とのインタラクションをカバーし、6種類の価格ブロックをトークンベースの数式エディターで組み合わせます。 このアーキテクチャにより、2つ目の製品は新たな開発プロジェクトではなく、組み立てによって実現できます。