# 商品 API ドキュメントと OpenAPI 統合 | MerchandAise

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

カスタム商品、コミュニティの埋め込み、サプライヤーのワークフロー、エンタープライズ ID に関する MerchandAise API ドキュメントと OpenAPI 仕様を調べてください。

## プロジェクトに必要な接続を選択してください
エンドポイント、リクエスト形式、認可要件を評価するには、以下の参考資料を使用してください。公開仕様は計画とクライアントの生成をサポートします。操作アクセスは API、アカウント、環境によって異なります。
MerchandAise が購入者の取引を処理する場合、Hutter Products GmbH は契約販売者であり、MerchandAise ブランドの下の登録販売者です。サプライヤーの身元と連絡先の詳細は、開示が必要な場合を除いて非公開のままであり、製造には依然としてデジタル証明の承認、確認された生産性、必須の技術検査、および正確に受け入れられた注文に適用されるサンプルの承認が必要です。

## API と統合サーフェス
- **API ドキュメントと OpenAPI:** アシスタント ツールとデザイン セッションの API リファレンスを見つけて、ワークフローのコミュニティ、サプライヤー、またはエンタープライズ契約を選択します。 実装ガイド: アシスタント ツールのドキュメントを読む (/api/docs). 機械契約: アシスタントツール OpenAPI JSON (/api/docs/openapi.json). アクセス: 公共. アシスタントおよびツール API の公開リファレンス。実稼働アクセスおよび注文に影響する操作には、引き続き適切な許可が必要です。 正規ページ: /ja/developers/api-integrations. 正規セクション: /ja/developers/api-integrations#api-docs.
- **コミュニティAPI:** クラブまたはコミュニティの Web サイトをコミュニティの公開情報、デザインの提出、投票、および承認の引き継ぎに接続します。 契約の内容: 公開コミュニティのコンテキスト、デザインの投稿と投票、リストの公開、保留中の注文、コミュニティ所有者の承認または拒否。 実践的な出発点: クラブ Web サイトの公開コミュニティのコンテキストを読みます。次に、デザインの送信やチェックアウトの引き継ぎを追加する前に、どのアクションにメンバー セッションまたは所有者の権限が必要かをマッピングします。 アクセス: 仕様は公開されています。パブリック読み取り、メンバーアクション、および所有者のみの操作には、異なる承認要件があります。各エンドポイントでセキュリティ ルールを使用します。 実装ガイド: コミュニティ API を探索する (/ja/developers/api-integrations#community-integrations). 機械契約: コミュニティ OpenAPI JSON (/api/v1/community/public/openapi/v1). アクセス: 公共. ストアフロントの埋め込み、コミュニティの検出、ロケールを意識したハンドオフのためのパブリック バージョンの契約。 正規ページ: /ja/developers/api-integrations. 正規セクション: /ja/developers/api-integrations#community-integrations.
- **サプライヤーAPI:** 承認されたサプライヤー システムを、リリースされた製品パッケージ、オンボーディング ステータス、ERP または PLM Webhook ワークフローに接続します。 契約の内容: サプライヤーのオンボーディング状態、リリースされた運用パッケージ、監査されたアーティファクトのダウンロード、分析、Webhook サブスクリプション、および同期チェックポイント。 実践的な出発点: ERP または製品ライフサイクル管理システムとサプライヤー センター間の接続を計画します。割り当てられた注文を処理する前に、Webhook ペイロード、再試行、同期ステータスを確認してください。 アクセス: サインインせずに OpenAPI 仕様をお読みください。操作リクエストには、適切なサプライヤー アカウントと権限が必要です。公開文書はサプライヤーを登録したり、別のサプライヤーのデータへのアクセスを許可したりするものではありません。 実装ガイド: サプライヤー API を探索する (/ja/developers/api-integrations#supplier-integrations). 機械契約: サプライヤー OpenAPI JSON (/api/v1/supplier/openapi/v1). アクセス: 公共. 企画とクライアント創出のための公共契約。運用上のサプライヤーへのアクセスは引き続き許可されます。 正規ページ: /ja/developers/api-integrations. 正規セクション: /ja/developers/api-integrations#supplier-integrations.
- **エンタープライズアイデンティティAPI:** 承認された企業ワークスペースをシングル サインオン、ユーザーとグループのプロビジョニング、ID 監査レコードに接続します。 契約の内容: OpenID Connect (OIDC) シングル サインオン、SCIM ユーザーおよびグループのライフサイクル操作、SCIM トークンのローテーション、およびプロビジョニング監査イベント。 実践的な出発点: ID プロバイダーを承認されたワークスペースにマップします。サインイン、ユーザーのプロビジョニングとプロビジョニング解除を計画し、合意されたテスト環境でグループ マッピングと監査レコードを検証します。 アクセス: エンタープライズ ID 仕様は保護されています。実装前に統合チームに連絡して、ワークスペースとアクセス要件を確認してください。通常の製品購入では、エンタープライズ ID はオプションです。 実装ガイド: エンタープライズ アイデンティティを探る (/ja/developers/api-integrations#enterprise-integrations). 機械契約: エンタープライズ ID OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). アクセス: 保護されています. 承認されたエンタープライズ ワークスペースの保護された契約。このエンドポイントを使用する前にアクセスをリクエストしてください。 正規ページ: /ja/developers/api-integrations. 正規セクション: /ja/developers/api-integrations#enterprise-integrations.

## コードの前に契約を選択してください
- **ステップ 1: ユーザージャーニーをマッピングする:** ワークフローに誰がどこから参加するかを決定します: 組み込み店頭の購入者、承認されたサプライヤー、企業ユーザー、または明示的な承認を得て操作するアシスタント。
- **ステップ 2: アクセス境界を確認する:** 評価とクライアント生成にはパブリック コントラクトを使用し、実装前に認証情報、スコープ、環境、コールバック、保護されたエンドポイントを確認します。
- **ステップ 3: 状態の連続性を証明する:** 再試行やロールバック パスを含め、統合全体にわたって設計、見積、承認、エラー、注文の引き継ぎが最新のバージョンに保たれていることをテストします。

## すべての統合で保持しなければならないもの
- **1 つのバージョン管理された状態:** デザイン、コマースの意図、サプライヤーによる見積、承認、注文ステータスは常につながり続けます。古い変更は、目に見える再見積またはレビュー状態をトリガーする必要があります。
- **商業およびサプライヤーのプライバシー:** MerchandAise は引き続き購入者向けの販売者およびサポート所有者です。サプライヤーの身元情報、連絡先、内部データは、公開統合を通じて公開されません。
- **生産前の承認:** 3D ビューは物的証拠ではありません。確認された見積書には、利用可能な顧客サンプルの選択肢、コスト、制限、およびタイミングが説明されています。大量生産の前に、正確なデジタル証明を承認し、必須の技術チェックと必須または選択されたサンプルの承認を完了します。既存の受注要件は引き続き拘束力を持ちます。

## 運用トラフィックの前
公開された OpenAPI ファイルは計画の表面であり、匿名の実稼働アクセスを約束するものではありません。稼働前に、環境、認証情報、障害処理、運用上の所有権をレビューします。
- **アクセスと環境:** 契約バージョン、承認されたワークスペース、認証スコープ、サンドボックス、本番認証情報、コールバック宛先を確認します。
- **失敗と回復:** 再試行、冪等性、タイムアウト、顧客に見えるエラー、可観測性、サポートの所有権、リリース前のロールバックを定義します。
- **エンドツーエンドの証拠:** エントリおよび状態の突然変異から、見積、承認、ハンドオフ、および回復動作に至るまでのステージングにおける意図された行程を検証します。

## FAQ
- **どの商品 API から始めるべきですか?:** まずは個人と状態の遷移から始めます。バイヤー向けのクラブまたはコミュニティのジャーニーにはコミュニティの埋め込みを使用し、承認されたサプライサイドのワークフローにはサプライヤーのオペレーションを、SSO および SCIM にはエンタープライズ ID を、明示的に承認された AI 主導のフローにのみアシスタント ツールを使用します。
- **公的契約とは、公的制作へのアクセスを意味しますか?:** いいえ。パブリック OpenAPI コントラクトは、検出、アーキテクチャのレビュー、クライアントの生成をサポートしています。運用資格情報、書き込み操作、サプライヤーのワークフロー、エンタープライズ ID、およびアシスタントの実行には、引き続き承認されたワークスペースと範囲指定された承認が必要な場合があります。
- **統合によりサプライヤーを公開したり、承認を回避したりできますか?:** いいえ。サプライヤーの身元と連絡先の詳細は、開示が必要な場合を除き非公開のままであり、MerchandAise が購入者との関係を所有しており、注文に影響するアクションでは、設定されたデジタルプルーフ、技術的、および注文固有のサンプル承認要件を保持する必要があります。

## 当社との統合を計画してください。
誰が統合を使用するのか、どの状態を読み取るか変更する必要があるのか、エクスペリエンスがどこに保存されるのかを教えてください。契約、アクセス モデル、最も安全なロールアウト パスをお客様と一緒に計画します。
- **統合を計画する:** /ja/contact?intent=api-integration-review
- **AI エージェントと MCP を探索する:** /ja/developers/ai-agents-mcp
