采购软件接入

把采购系统接入中国供应商搜索

可以读取公开采购机会和供应商资料，也可以用获批的服务密钥检查订单要求。买家联系人、完整询价、报价、聊天消息和账号资料不会公开。

公开接口

以下定义可以公开读取；保存采购需求、联系供应商和进入对接室仍需登录。

GET

/.well-known/agent-card.json

服务身份、支持的订单检查、数据限制和说明链接。

GET

/api/v1/capabilities

订单和供应商检查清单，包含 JSON 输入输出、角色、语言和访问规则。

GET

/api/v1/capabilities/{capability_id}

按 ID 读取单项定义；不存在的 ID 返回 404。

GET

/api/v1/public/opportunities

公开采购机会，不包含买家姓名、联系方式、来源网址、内部备注和完整询价。

GET

/api/v1/public/suppliers

供买家查看的供应商资料，不包含联系人、聊天、报价和账号编号。

调用订单检查

获批合作方可以调用目录中的检查项目。每次请求都要带服务密钥和唯一的重试编号。

POST /api/v1/capabilities/sourcing-brief-quality-check/execute
X-API-Key: your-service-key
Idempotency-Key: order-check-20260831-001
Content-Type: application/json

{
  "caller_role": "buyer_agent",
  "target_role": "supplier_agent",
  "language": "zh-CN",
  "source": "partner_name",
  "input": {"request_text": "采购 500 个符合 FCC 要求的蓝牙耳机，交货到加拿大"}
}

返回内容包含执行编号、状态、完整度、仍需核对的资料和结构化结果。使用同一个重试编号再次提交相同内容，会返回上次结果。

在合作网站加入采购检查框

嵌入框只显示订单完整度和匿名供应商数量，不会把买卖双方联系人交给合作网站。

<script src="https://maplebridge.io/sourcing-widget.js"
  data-partner="your-site"
  data-lang="zh"></script>

区分买家和供应商

买家或供应商身份需要单独传入。买家写了“寻找供应商”，仍应作为采购需求处理。

{
  "capability_id": "supplier-capability-normalizer",
  "caller_role": "supplier_agent",
  "target_role": "buyer_agent",
  "language": "zh-CN",
  "supplier_text": "东莞蓝牙耳机工厂，MOQ 500，支持定制包装"
}

JSON 字段固定

每项定义都有固定 ID、版本、JSON Schema、示例、错误名称、登录要求和数据规则。

客户资料不会公开

公开接口只返回定义和示例，不包含买家身份、供应商联系人、完整询价、报价和聊天消息。

可接入现有采购软件

采购软件和 Agent 平台可以读取公开定义，但不能控制 MapleBridge 的账号、订单和客户资料。

交易操作需要登录

公开定义不是开放的交易接口。保存订单、联系供应商或发送消息前，请检查 authentication 字段。