
互通前提
互通发生在两个或多个主体之间。每个参与方分别登记 Agent 身份和授权范围,说明可调用对象、字段和期限。双方记录都处于有效状态时,互通才能完成。
互通不只依赖标识。标识只用于发现目标,是否允许调用由目标 Agent 按授权范围判断。调用方不应把标识当作通行凭据。
互通前应确认双方的授权范围有交集。只有目标允许调用方访问的能力和字段才会返回,交集之外的内容不出现在结果中。
互通流程
业务调用由双方系统直接完成。平台返回端点和授权信息,不转发业务数据,也不保存业务正文。
每一步都有失败可能。身份校验不通过时不进入授权判断,授权不通过时不返回端点,调用记录只在请求进入后生成。
- 调用方提交自身标识和目标标识。
- 系统校验双方身份和记录版本。
- 判断调用方是否在目标授权范围内。
- 返回目标端点和可用字段。
- 调用方发起业务调用,平台写入调用记录。
跨主体边界
边界在接入时确认。双方可以约定字段范围、调用方向和期限,平台按登记内容判断,不代替双方协商业务条件。
平台不判断双方业务资质,也不介入合同条款。跨主体协作的商务条件、数据用途和责任划分,由参与方自行确认。
| 事项 | 平台处理 | 平台不处理 |
|---|---|---|
| 身份 | 登记和校验双方标识 | 代替主体判断业务资质 |
| 授权 | 按登记范围判断 | 代替双方签署业务合同 |
| 数据 | 不保存业务正文 | 转发业务结果 |
| 记录 | 保存调用时间、双方标识和结果 | 保存业务数据内容 |
失败处理
调用方不应通过重复请求绕过授权限制。出现异常时保留请求编号和记录编号,便于双方核对。
失败时先看错误类型,再定位环节。目标停用查登记状态,授权过期查授权范围,端点不可达查端点记录,版本不一致重新匹配。
- 目标停用:暂停调用,联系目标主体。
- 授权过期:提交授权调整。
- 端点不可达:核对端点,提交端点变更。
- 版本不一致:重新匹配后调用。
责任分工
主体对 Agent 的业务行为、数据质量和结果负责。平台负责身份登记、匹配、授权判断和调用记录,不评价业务效果,不保证目标服务持续可用。
跨主体协作涉及个人信息时,双方应在调用前完成脱敏,并确认数据使用范围。国家秘密和重要数据不得接入。
平台保留的记录用于核对调用是否发生在授权范围内。双方对业务结果有异议时,按各自系统记录处理,平台记录只用于身份和寻址环节。