01
助手工具 API 文档
探索用于设计会话及集成评审的当前助手与工具端点。此公开参考文档不赋予匿名报价或下单权限。
MerchandAise 开发者平台
统一的产品工作流，四种接入方式。
将网站、社区、供应商业务或企业工作区连接至同一版本化的设计、报价、审批与订单状态。从已发布的契约开始，与我们共同规划访问权限与生产上线。
保持单一真实数据源
集成应当扩展 MerchandAise 工作流，而非分叉它。网站、内嵌组件、供应商、企业以及未来的助手端，都必须读取并更新相同的版本化设计、商业意图、报价、审批及订单状态。
在 MerchandAise 处理买家交易的同时，Hutter Products GmbH 作为签约卖方和 MerchandAise 品牌旗下的官方商户（Merchant of Record）。除法规要求披露外，供应商的身份与联系方式将保持保密，且生产仍须通过数码样稿与实物样品的审批。
01 — 契约
API 与集成界面
02
社区内嵌 API
将本地化的俱乐部、社区或店面体验连接到由 MerchandAise 运营的设计与商业交接流程，无需重建底层工作流。
03
供应商 API
在完成供应商关系与访问模型的资质审核后，将获批的供应商连接至入驻、目录、报价与履约业务。
04
企业身份 API
为获批的公司商品项目及规范化上线规划 SSO、SCIM 配置以及符合审计要求的身份流。
访问权限: protected
机器契约
企业身份 OpenAPI JSON/api/v1/enterprise/identity/openapi/v1获批企业工作区的受保护契约；在使用此端点前请申请访问权限。
02 — 实施指南
先选契约，后写代码
- 01
映射用户旅程
确定谁将进入工作流以及在何处进入：内嵌店面中的买家、获批的供应商、企业用户，或获得明确授权运行的助手。
- 02
确认访问边界
使用公开契约进行评估与客户端生成，随后在实施前确认凭证、作用域、环境、回调及受保护的端点。
- 03
验证状态连续性
测试设计、报价、审批、错误以及订单交接在集成过程中保持版本同步，包括重试与回滚路径。
03 — 每项集成必须守住的底线
每项集成必须守住的底线
单一版本化状态
设计、商业意图、供应商支持的报价、审批与订单状态始终保持互联。过时的更改必须触发明显的重新报价或审核状态。
商业与供应商隐私
MerchandAise 依然是面向买家的商户及客服主体。供应商身份、联系方式及内部数据不会通过公开集成暴露。
投产前的审批
产品原生 3D 视图和数码样稿支持决策，但它们不能替代大规模生产前所必需的真实实物样品。
04
在生产流量上线前
已发布的 OpenAPI 文件是一个规划参考，而非匿名生产访问的承诺。我们在正式上线前会审核环境、凭证、故障处理和运营权责。
访问与环境
确认契约版本、获批的工作区、认证作用域、沙箱、生产凭证以及回调目标地址。
故障与恢复
在发布前明确重试、幂等性、超时、面向客户的错误提示、可观测性、支持归属以及回滚方案。
端到端证据
在预发环境中验证预期的旅程，从入口和状态变更，一直到报价、审批、交接及恢复行为。
常见问题
我应该从哪个集成界面开始？
从人员和状态流转开始。面向买家的俱乐部或社区旅程使用社区内嵌，获批的供给侧工作流使用供应商业务，SSO 与 SCIM 使用企业身份，而助手工具仅用于获得明确授权的、由 AI 主导的流程。
公开契约是否意味着公开的生产访问权限？
不是。公开的 OpenAPI 契约用于发现、架构评审和客户端生成。生产凭证、写操作、供应商工作流、企业身份和助手执行仍可能需要获批的工作区和具有作用域的授权。
集成是否可以暴露供应商或绕过审批？
不可以。除法律法规要求披露外，供应商身份与联系方式保持保密；MerchandAise 拥有买家关系；且涉及订单的操作必须保留已配置的审批和真实样品关卡。
带上您的工作流来找我们，无需准备完整的架构。
告诉我们谁将使用此集成、他们需要读取或更改哪些状态，以及体验将落地何处。我们将与您一同规划契约、访问模型及最安全的上线路径。