# 商品 API 文档和 OpenAPI 集成 | MerchandAise

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

探索 MerchandAise API 文档和 OpenAPI 规范，了解定制商品、社区嵌入、供应商工作流程和企业身份。

## 选择您的项目需要的连接
使用下面的参考来评估端点、请求格式和授权要求。公共规范支持规划和客户生成；操作访问取决于API、帐户和环境。
其中 MerchandAise 处理买方交易，Hutter Products GmbH 是 MerchandAise 品牌下的签约卖方和记录商户。除非需要披露，否则供应商身份和联系方式均保密，生产仍需要数字校样批准、确认的可生产性、强制性技术检查以及适用于确切已接受订单的样品批准。

## API 和集成界面
- **API 文档和 OpenAPI:** 查找助理工具和设计会话的 API 参考，然后为您的工作流程选择社区、供应商或企业合同。 实施指南: 阅读助理工具文档 (/api/docs). 机器合同: 辅助工具 OpenAPI JSON (/api/docs/openapi.json). 访问: 公共. 助手和工具 API 的公共参考。生产访问和影响订单的操作仍然需要适用的授权。 规范页面: /zh/developers/api-integrations. 规范部分: /zh/developers/api-integrations#api-docs.
- **社区API:** 将俱乐部或社区网站连接到公共社区信息、设计提交、投票和订单批准移交。 合同涵盖哪些内容: 公共社区背景、设计帖子和投票、列表发布、待处理订单以及社区所有者批准或拒绝。 实用的起点: 阅读俱乐部网站的公共社区背景。然后在添加设计提交或结帐交接之前映射哪些操作需要成员会话或所有者权限。 访问: 该规范是公开的。公共读取、成员操作和所有者专用操作具有不同的授权要求；在每个端点上使用安全规则。 实施指南: 探索社区 API (/zh/developers/api-integrations#community-integrations). 机器合同: 社区 OpenAPI JSON (/api/v1/community/public/openapi/v1). 访问: 公共. 用于店面嵌入、社区发现和区域设置感知切换的公共版本合同。 规范页面: /zh/developers/api-integrations. 规范部分: /zh/developers/api-integrations#community-integrations.
- **供应商API:** 将批准的供应商系统连接到已发布的生产包、入职状态和 ERP 或 PLM Webhook 工作流程。 合同涵盖哪些内容: 供应商入职状态、发布的生产包、审核的工件下载、分析、Webhook 订阅和同步检查点。 实用的起点: 规划您的 ERP 或产品生命周期管理系统与供应商中心之间的连接。在处理分配的订单之前查看 Webhook 负载、重试和同步状态。 访问: 无需登录即可阅读OpenAPI规范。操作请求需要相应的供应商帐户和权限；公共文档不会注册供应商或授予对其他供应商数据的访问权限。 实施指南: 探索供应商 API (/zh/developers/api-integrations#supplier-integrations). 机器合同: 供应商 OpenAPI JSON (/api/v1/supplier/openapi/v1). 访问: 公共. 规划和客户生成的公共合同。运营供应商访问权限仍然获得许可。 规范页面: /zh/developers/api-integrations. 规范部分: /zh/developers/api-integrations#supplier-integrations.
- **企业身份API:** 将批准的公司工作空间连接到单点登录、用户和组配置以及身份审核记录。 合同涵盖哪些内容: OpenID Connect (OIDC) 单点登录、SCIM 用户和组生命周期操作、SCIM 令牌轮换以及配置审核事件。 实用的起点: 将您的身份提供商映射到批准的工作区。规划登录、用户配置和取消配置，然后在商定的测试环境中验证组映射和审核记录。 访问: 企业身份规范受到保护。在实施之前联系集成团队以检查工作区和访问要求。对于普通产品购买，企业标识是可选的。 实施指南: 探索企业形象 (/zh/developers/api-integrations#enterprise-integrations). 机器合同: 企业身份 OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). 访问: 受保护. 经批准的企业工作空间的受保护合同；在使用此端点之前请求访问。 规范页面: /zh/developers/api-integrations. 规范部分: /zh/developers/api-integrations#enterprise-integrations.

## 在代码之前选择合同
- **步骤 1: 绘制用户旅程图:** 决定谁进入工作流程以及在哪里：嵌入式店面中的买家、批准的供应商、企业用户或具有明确授权的操作助理。
- **步骤 2: 确认访问边界:** 使用公共合约进行评估和客户端生成，然后在实施之前确认凭证、范围、环境、回调和受保护的端点。
- **步骤 3: 证明状态连续性:** 测试设计、报价、批准、错误和订单移交在整个集成过程中保持最新版本，包括重试和回滚路径。

## 每次集成都必须保留什么
- **一种版本状态:** 设计、商业意图、供应商支持的报价、批准和订单状态保持联系。过时的更改必须触发可见的重新报价或审核状态。
- **商业和供应商隐私:** MerchandAise 仍然是面向买家的商家和支持所有者。供应商身份、联系人和内部数据不会通过公共集成公开。
- **生产前审批:** 3D 视图不是物理证据。确认的报价解释了任何可用的客户样品选择、成本、限制和时间安排。在批量生产之前批准准确的数字校样并完成强制性技术检查以及任何所需或选定的样品批准。现有的接受订单要求仍然具有约束力。

## 生产前流量
发布的 OpenAPI 文件是一个规划表面，而不是匿名生产访问的承诺。我们在上线之前会审查环境、凭证、故障处理和运营所有权。
- **访问和环境:** 确认合同版本、批准的工作区、身份验证范围、沙箱、生产凭证和回调目标。
- **失败与恢复:** 定义重试、幂等性、超时、客户可见错误、可观察性、支持所有权以及发布前回滚。
- **端到端证据:** 通过报价、批准、移交和恢复行为验证从进入到状态突变的预期旅程。

## 常见问题解答
- **我应该从哪个商品 API 开始？:** 从人和状态的转变开始。将社区嵌入用于面向买家的俱乐部或社区旅程，将供应商运营用于已批准的供应方工作流程，将企业身份用于 SSO 和 SCIM，以及仅用于明确授权的 AI 主导流程的辅助工具。
- **公共合同是否意味着公共生产准入？:** 不会。公共 OpenAPI 合约支持发现、架构审查和客户端生成。生产凭证、写入操作、供应商工作流程、企业身份和助理执行仍然需要经过批准的工作空间和范围授权。
- **集成是否会暴露供应商或绕过审批？:** 不可以。除非需要披露，否则供应商身份和联系方式将保持保密，MerchandAise 拥有买方关系，并且影响订单的操作必须保留配置的数字校样、技术和特定于订单的样品批准要求。

## 规划您与我们的融合。
告诉我们谁将使用集成、他们需要阅读或更改哪些状态以及体验将存在于何处。我们将与您一起制定合同、访问模型和最安全的部署路径。
- **规划整合:** /zh/contact?intent=api-integration-review
- **探索 AI 代理和 MCP:** /zh/developers/ai-agents-mcp
