MerchandAise 開発者プラットフォーム
ウェブサイト、コミュニティ、サプライヤー業務、またはエンタープライズのワークスペースを、同一のバージョン管理されたデザイン、見積もり、承認、および注文ステータスに接続します。まずは公開されたコントラクトから開始し、アクセス権と本番環境への展開計画を当社と共同で策定してください。
システム連携はMerchandAiseのワークフローを拡張するものであり、分岐（フォーク）させるものではありません。ウェブサイト、埋め込み、サプライヤー、エンタープライズ、そして将来のアシスタント向けインターフェースは、すべて同一のバージョン管理されたデザイン、取引意図、見積もり、承認、および注文ステータスを参照・更新する必要があります。
MerchandAiseが購入者の取引を処理する場合、Hutter Products GmbHが契約上の販売者であり、MerchandAiseブランドにおける登録加盟店（Merchant of Record）となります。サプライヤーの身元および連絡先情報は、開示が義務付けられている場合を除き非公開に保たれます。また、量産を開始するには、デジタル校正および実物の制作サンプルの承認が引き続き必要です。
01 — コントラクト
01
デザインセッションや統合レビュー向けのアシスタントおよびツール用エンドポイントをご確認いただけます。この公開リファレンスは、匿名のユーザーに見積もりや注文の権限を付与するものではありません。
実装ガイド
アシスタントツール用ドキュメントを開くマシンコントラクト
アシスタントツール OpenAPI JSON
/api/docs/openapi.jsonアシスタントおよびツールAPI用の公開リファレンスです。本番環境へのアクセスおよび注文に影響を与える操作には、引き続き適切な認可が必要です。
02
基盤となるワークフローを再構築することなく、ローカライズされたクラブ、コミュニティ、またはストアフロントの体験を、MerchandAiseが管理するデザインおよび取引のハンドオフに接続します。
マシンコントラクト
コミュニティ OpenAPI JSON/api/v1/community/public/openapi/v1ストアフロントの埋め込み、コミュニティのディスカバリー、およびロケール対応のハンドオフ向けの、公開されたバージョン管理済みコントラクトです。
03
サプライヤーとの提携関係およびアクセスモデルの適格性が確認された後、承認されたサプライヤーをオンボーディング、カタログ、見積もり、およびフルフィルメント業務に接続します。
マシンコントラクト
サプライヤー OpenAPI JSON/api/v1/supplier/openapi/v1計画およびクライアント生成用の公開コントラクトです。実際のサプライヤー業務へのアクセスには、引き続き権限付与が必要です。
04
承認された企業向けグッズプログラムや統制された展開に向けて、SSO、SCIMプロビジョニング、および監査対応のIDフローを計画します。
マシンコントラクト
エンタープライズID OpenAPI JSON/api/v1/enterprise/identity/openapi/v1承認されたエンタープライズワークスペース向けの保護されたコントラクトです。このエンドポイントを使用する前にアクセス権を申請してください。
02 — 実装ガイド
埋め込みストアフロントの購入者、承認されたサプライヤー、エンタープライズユーザー、または明示的な認可を得て動作するアシスタントなど、誰がどこからワークフローに入るかを決定します。
評価やクライアント生成には公開コントラクトを使用し、実装前に資格情報、スコープ、環境、コールバック、および保護されたエンドポイントを確認します。
リトライやロールバック経路を含め、デザイン、見積もり、承認、エラー、および注文のハンドオフが、統合全体で常に最新バージョンに維持されていることをテストします。
03 — すべての統合において維持すべき必須要件
デザイン、取引意図、サプライヤー裏付けの見積もり、承認、および注文ステータスは常に連携されます。古い変更が発生した場合は、明示的な再見積もりまたは確認ステータスをトリガーする必要があります。
MerchandAiseは引き続き購入者向けの販売者およびサポートの責任者となります。サプライヤーの身元、連絡先、および内部データが公開統合を通じて公開されることはありません。
製品ネイティブの3D表示やデジタル校正は意思決定をサポートしますが、量産前に必須となる実物の制作サンプルの代わりにはなりません。
04
公開されたOpenAPIファイルは計画用のインターフェースであり、匿名の本番アクセスを保証するものではありません。サービス開始前に、環境、資格情報、エラー処理、および運用の責任体制をレビューします。
コントラクトのバージョン、承認されたワークスペース、認証スコープ、サンドボックス、本番環境の資格情報、およびコールバック先を確認します。
リリース前に、リトライ、べき等性、タイムアウト、顧客に表示されるエラー、オブザーバビリティ、サポートの責任体制、およびロールバックを定義します。
ステージング環境において、開始からステータスの変更、見積もり、承認、ハンドオフ、およびリカバリー動作に至るまで、想定されたジャーニーを検証します。
対象となるユーザーとステータスの遷移から開始してください。購入者向けのクラブやコミュニティのジャーニーにはコミュニティ埋め込みを、承認された供給側のワークフローにはサプライヤー業務を、SSOやSCIMにはエンタープライズIDを、そして明示的に認可されたAI主導のフローにはアシスタントツールを使用します。
いいえ。公開されているOpenAPIコントラクトは、ディスカバリー、アーキテクチャのレビュー、およびクライアント生成をサポートするためのものです。本番環境の資格情報、書き込み操作、サプライヤーのワークフロー、エンタープライズID、およびアシスタントの実行には、引き続き承認されたワークスペースとスコープが設定された認可が必要です。
いいえ。サプライヤーの身元および連絡先情報は、開示が義務付けられている場合を除き非公開に保たれます。また、MerchandAiseが購入者との関係を管理し、注文に影響を与えるアクションは、設定された承認および実物サンプルによる検証ゲートを必ず維持する必要があります。
誰が統合を利用するのか、どのステータスを読み取りまたは変更する必要があるのか、そしてその体験がどこで提供されるのかをお知らせください。最適なコントラクト、アクセスモデル、および最も安全な展開経路を共同で設計いたします。