# API ドキュメント + コミュニティに API を埋め込む | MerchandAise

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

計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める OpenAPI 契約を確認します。 ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。 MerchandAise API、OpenAPI コントラクト、コミュニティ埋め込み、サプライヤー ワークフロー、エンタープライズ ID、および MCP ツールを使用して、カスタム商品を Web サイト、ポータル、および AI エージェントに接続します。

## 統合サーフェスとコントラクト
MerchandAise API、OpenAPI コントラクト、コミュニティ埋め込み、サプライヤー ワークフロー、エンタープライズ ID、および MCP ツールを使用して、カスタム商品を Web サイト、ポータル、および AI エージェントに接続します。
計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める OpenAPI 契約を確認します。
ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。

## 統合サーフェスとコントラクト
- **API ドキュメント:** 計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める OpenAPI 契約を確認します。 Human guide: API ドキュメント (/api/docs). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **コミュニティに API を埋め込む:** ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。 Human guide: コミュニティに API を埋め込む (/ja/community). Machine-readable contract: オープンコミュニティ契約 (/api/v1/community/public/openapi/v1). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **サプライヤー API:** フルフィルメント ワークフロー用に構築されたバージョン管理されたエンドポイントを通じて、オンボーディング、カタログ、サプライヤー側の操作を接続します。 Human guide: サプライヤー API (/ja/partners). Machine-readable contract: オープンサプライヤー契約 (/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: エンタープライズ ID API (/ja/enterprise). Machine-readable contract: オープンエンタープライズアイデンティティ契約 (/api/v1/enterprise/identity/openapi/v1). Access: protected. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## 統合クイックスタート
- **Step 1: ワークフローに合った契約を選択してください:** ユーザーと認証モデルに一致するサーフェス (コミュニティの埋め込み、エンタープライズ ID、サプライヤーの運用、またはアシスタント用の MCP ツール) から始めます。
- **Step 2: 認証、バージョン管理、環境の境界を検証する:** 本番トラフィックをルーティングする前に、ステージングで必要なヘッダー、スコープ、コールバックの期待、および契約バージョンを確認してください。
- **Step 3: 導入前にエンドツーエンドのワークフローをテストする:** リクエスト、Webhook、プロビジョニング、可観測性、ロールバック パスを検証して、最初のライブ使用時から統合が信頼できるようにします。

## MerchandAise を使用してビルドする人
- **コミュニティオペレーター:** バージョン管理された公開契約を使用して、クラブ、リーグ、企業のサイト内で埋め込みストアフロント、コンフィギュレーターのハンドオフ、コミュニティ フローを開始します。
- **エンタープライズチームとプラットフォームパートナー:** 承認やサプライヤーのロジックを再構築することなく、調達ポータル、ID システム、内部業務を商品ワークフローに接続します。
- **AI エージェントと自動化ビルダー:** アシスタントに、MCP 互換エンドポイントを介した検出、引用、および承認された操作のための構造化されたツールへのアクセスを提供します。

## 統合レビューが必要ですか?
アーキテクチャ、ロールアウトのタイムライン、宛先チャネルを共有します。適切なコントラクト サーフェス、認証パターン、起動シーケンスを推奨します。
- **統合チームに相談する:** /ja/contact
- **View AI Agents and MCP:** /ja/developers/ai-agents-mcp