# グッズ制作API＆統合コントラクト | MerchandAise

- slug: developers-api-integrations
- locale: ja
- localeResolved: ja
- canonical: https://www.merchandaise.com/ja/developers/api-integrations

アシスタントツール、コミュニティ埋め込み、サプライヤー業務、エンタープライズID向けのMerchandAiseコントラクトをご覧ください。公開および保護されたアクセス境界が明確に定義されています。

## 単一の信頼できる情報源（Source of Truth）の維持
システム連携はMerchandAiseのワークフローを拡張するものであり、分岐（フォーク）させるものではありません。ウェブサイト、埋め込み、サプライヤー、エンタープライズ、そして将来のアシスタント向けインターフェースは、すべて同一のバージョン管理されたデザイン、取引意図、見積もり、承認、および注文ステータスを参照・更新する必要があります。
MerchandAiseが購入者の取引を処理する場合、Hutter Products GmbHが契約上の販売者であり、MerchandAiseブランドにおける登録加盟店（Merchant of Record）となります。サプライヤーの身元および連絡先情報は、開示が義務付けられている場合を除き非公開に保たれます。また、量産を開始するには、デジタル校正および実物の制作サンプルの承認が引き続き必要です。

## APIおよび統合インターフェース
- **アシスタントツールAPIドキュメント:** デザインセッションや統合レビュー向けのアシスタントおよびツール用エンドポイントをご確認いただけます。この公開リファレンスは、匿名のユーザーに見積もりや注文の権限を付与するものではありません。 Human guide: アシスタントツール用ドキュメントを開く (/ja/developers/api-integrations). Machine-readable contract: アシスタントツール OpenAPI JSON (/api/docs/openapi.json). Access: public. アシスタントおよびツールAPI用の公開リファレンスです。本番環境へのアクセスおよび注文に影響を与える操作には、引き続き適切な認可が必要です。 Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **コミュニティ埋め込みAPI:** 基盤となるワークフローを再構築することなく、ローカライズされたクラブ、コミュニティ、またはストアフロントの体験を、MerchandAiseが管理するデザインおよび取引のハンドオフに接続します。 Human guide: コミュニティ統合ガイドを確認する (/ja/developers/api-integrations#community-integrations). Machine-readable contract: コミュニティ OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. ストアフロントの埋め込み、コミュニティのディスカバリー、およびロケール対応のハンドオフ向けの、公開されたバージョン管理済みコントラクトです。 Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **サプライヤーAPI:** サプライヤーとの提携関係およびアクセスモデルの適格性が確認された後、承認されたサプライヤーをオンボーディング、カタログ、見積もり、およびフルフィルメント業務に接続します。 Human guide: サプライヤー統合ガイドを確認する (/ja/developers/api-integrations#supplier-integrations). Machine-readable contract: サプライヤー OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. 計画およびクライアント生成用の公開コントラクトです。実際のサプライヤー業務へのアクセスには、引き続き権限付与が必要です。 Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **エンタープライズID API:** 承認された企業向けグッズプログラムや統制された展開に向けて、SSO、SCIMプロビジョニング、および監査対応のIDフローを計画します。 Human guide: エンタープライズ統合ガイドを確認する (/ja/developers/api-integrations#enterprise-integrations). Machine-readable contract: エンタープライズID OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. 承認されたエンタープライズワークスペース向けの保護されたコントラクトです。このエンドポイントを使用する前にアクセス権を申請してください。 Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## コードを書く前にコントラクトを選択する
- **Step 1: ユーザージャーニーのマッピング:** 埋め込みストアフロントの購入者、承認されたサプライヤー、エンタープライズユーザー、または明示的な認可を得て動作するアシスタントなど、誰がどこからワークフローに入るかを決定します。
- **Step 2: アクセス境界の確認:** 評価やクライアント生成には公開コントラクトを使用し、実装前に資格情報、スコープ、環境、コールバック、および保護されたエンドポイントを確認します。
- **Step 3: ステータス継続性の検証:** リトライやロールバック経路を含め、デザイン、見積もり、承認、エラー、および注文のハンドオフが、統合全体で常に最新バージョンに維持されていることをテストします。

## すべての統合において維持すべき必須要件
- **単一のバージョン管理されたステータス:** デザイン、取引意図、サプライヤー裏付けの見積もり、承認、および注文ステータスは常に連携されます。古い変更が発生した場合は、明示的な再見積もりまたは確認ステータスをトリガーする必要があります。
- **取引およびサプライヤーのプライバシー保護:** MerchandAiseは引き続き購入者向けの販売者およびサポートの責任者となります。サプライヤーの身元、連絡先、および内部データが公開統合を通じて公開されることはありません。
- **生産開始前の承認:** 製品ネイティブの3D表示やデジタル校正は意思決定をサポートしますが、量産前に必須となる実物の制作サンプルの代わりにはなりません。

## 本番トラフィックの開始前に
公開されたOpenAPIファイルは計画用のインターフェースであり、匿名の本番アクセスを保証するものではありません。サービス開始前に、環境、資格情報、エラー処理、および運用の責任体制をレビューします。
- **アクセス権と環境:** コントラクトのバージョン、承認されたワークスペース、認証スコープ、サンドボックス、本番環境の資格情報、およびコールバック先を確認します。
- **障害とリカバリー:** リリース前に、リトライ、べき等性、タイムアウト、顧客に表示されるエラー、オブザーバビリティ、サポートの責任体制、およびロールバックを定義します。
- **エンドツーエンドの検証:** ステージング環境において、開始からステータスの変更、見積もり、承認、ハンドオフ、およびリカバリー動作に至るまで、想定されたジャーニーを検証します。

## よくある質問
- **どの統合インターフェースから始めるべきですか？:** 対象となるユーザーとステータスの遷移から開始してください。購入者向けのクラブやコミュニティのジャーニーにはコミュニティ埋め込みを、承認された供給側のワークフローにはサプライヤー業務を、SSOやSCIMにはエンタープライズIDを、そして明示的に認可されたAI主導のフローにはアシスタントツールを使用します。
- **公開コントラクトは、本番環境への公開アクセスを意味しますか？:** いいえ。公開されているOpenAPIコントラクトは、ディスカバリー、アーキテクチャのレビュー、およびクライアント生成をサポートするためのものです。本番環境の資格情報、書き込み操作、サプライヤーのワークフロー、エンタープライズID、およびアシスタントの実行には、引き続き承認されたワークスペースとスコープが設定された認可が必要です。
- **統合によってサプライヤー情報が公開されたり、承認プロセスをバイパスしたりすることはありますか？:** いいえ。サプライヤーの身元および連絡先情報は、開示が義務付けられている場合を除き非公開に保たれます。また、MerchandAiseが購入者との関係を管理し、注文に影響を与えるアクションは、設定された承認および実物サンプルによる検証ゲートを必ず維持する必要があります。

## 完成されたアーキテクチャではなく、ワークフローをご提示ください。
誰が統合を利用するのか、どのステータスを読み取りまたは変更する必要があるのか、そしてその体験がどこで提供されるのかをお知らせください。最適なコントラクト、アクセスモデル、および最も安全な展開経路を共同で設計いたします。
- **統合を計画する:** /ja/contact?intent=api-integration-review
- **AIエージェントとMCPを探索する:** /ja/developers/ai-agents-mcp