Documentation menu

連携インターフェースの概要

PartGridでサポートされるブラウザ側・サーバー側インターフェースと、連携契約として使用してはいけない内部ルートを理解します。

リファレンスの範囲

このページでは、内部アプリケーションルートを公開せずに、サポートされる連携境界を説明します。公開ブラウザ実装では生成されたiframeを使用してください。承認済みパートナーおよびサーバー側連携には、バージョン管理されたエンドポイント仕様と認証情報がPartGridから直接提供されます。

生成された埋め込み

PartGridが生成するiframe URLが、サポートされるブラウザ向け連携です。基盤サービスのエンドポイントへ直接アクセスせずに、公開図面データ、コレクションナビゲーション、ローカライズ、価格、テーマ、対応する顧客操作を処理します。導入方法とサポートされるディープリンクについては埋め込みガイドを参照してください。

カスタマイズ

テーマの作成、公開、割り当てはPartGrid内で管理します。Advanced modeで使用する完全なテーマJSONは管理対象の製品形式であり、公開APIペイロードではありません。承認済みのカスタムスタイル契約では、--pf-primary が現在文書化されている安定した埋め込み変数です。詳しくは埋め込みテーマを参照してください。

ストアフロントイベント

ブラウザイベントやペイロードは、PartGridが明示的にサポート対象として文書化しているものだけを使用してください。管理対象ビューアー内にpostMessage呼び出しが存在するだけでは、そのイベント名やペイロードが公開互換性契約になるわけではありません。

見積

見積依頼は、サポートされるPartGrid埋め込みフローから送信してください。ビューアーは公開体験に必要な会社設定と検証を適用します。内部の見積送信・追跡ルートへの直接アクセスはサポートされません。顧客と営業の流れは見積管理の仕組みを参照してください。

Shopware連携

対応するカテゴリ、製品、図面、ストアフロントのワークフローには、公式PartGrid Shopware連携を使用してください。プラグインがPartGridとの認証済み通信を管理します。受信パス、ペイロード、署名、同期の内部動作は公開APIではありません。