{"pageKey":"Developers","slug":"developers-api-integrations","locale":"ja","localeResolved":"ja","fallbackApplied":false,"version":"developers-api-integrations@2026-03-20T08:17:49.091Z","lastModified":"2026-03-20T08:17:49.091Z","canonicalUrl":"https://www.merchandaise.com/ja/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API ドキュメント + コミュニティに API を埋め込む | MerchandAise","description":"計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める OpenAPI 契約を確認します。 ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。 MerchandAise API、OpenAPI コントラクト、コミュニティ埋め込み、サプライヤー ワークフロー、エンタープライズ ID、および MCP ツールを使用して、カスタム商品を Web サイト、ポータル、および AI エージェントに接続します。","sections":[{"heading":"統合サーフェスとコントラクト","paragraphs":["MerchandAise API、OpenAPI コントラクト、コミュニティ埋め込み、サプライヤー ワークフロー、エンタープライズ ID、および MCP ツールを使用して、カスタム商品を Web サイト、ポータル、および AI エージェントに接続します。","計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める OpenAPI 契約を確認します。","ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。"]},{"heading":"統合サーフェスとコントラクト","items":[{"title":"API ドキュメント","description":"計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める 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."},{"title":"コミュニティに API を埋め込む","description":"ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。 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."},{"title":"サプライヤー API","description":"フルフィルメント ワークフロー用に構築されたバージョン管理されたエンドポイントを通じて、オンボーディング、カタログ、サプライヤー側の操作を接続します。 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."},{"title":"エンタープライズ ID API","description":"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."}]},{"heading":"統合クイックスタート","items":[{"title":"Step 1: ワークフローに合った契約を選択してください","description":"ユーザーと認証モデルに一致するサーフェス (コミュニティの埋め込み、エンタープライズ ID、サプライヤーの運用、またはアシスタント用の MCP ツール) から始めます。"},{"title":"Step 2: 認証、バージョン管理、環境の境界を検証する","description":"本番トラフィックをルーティングする前に、ステージングで必要なヘッダー、スコープ、コールバックの期待、および契約バージョンを確認してください。"},{"title":"Step 3: 導入前にエンドツーエンドのワークフローをテストする","description":"リクエスト、Webhook、プロビジョニング、可観測性、ロールバック パスを検証して、最初のライブ使用時から統合が信頼できるようにします。"}]},{"heading":"MerchandAise を使用してビルドする人","items":[{"title":"コミュニティオペレーター","description":"バージョン管理された公開契約を使用して、クラブ、リーグ、企業のサイト内で埋め込みストアフロント、コンフィギュレーターのハンドオフ、コミュニティ フローを開始します。"},{"title":"エンタープライズチームとプラットフォームパートナー","description":"承認やサプライヤーのロジックを再構築することなく、調達ポータル、ID システム、内部業務を商品ワークフローに接続します。"},{"title":"AI エージェントと自動化ビルダー","description":"アシスタントに、MCP 互換エンドポイントを介した検出、引用、および承認された操作のための構造化されたツールへのアクセスを提供します。"}]},{"heading":"統合レビューが必要ですか?","paragraphs":["アーキテクチャ、ロールアウトのタイムライン、宛先チャネルを共有します。適切なコントラクト サーフェス、認証パターン、起動シーケンスを推奨します。"],"items":[{"title":"統合チームに相談する","description":"/ja/contact"},{"title":"View AI Agents and MCP","description":"/ja/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}