了解预制连接器、项目化连接器和 HTTP 组件的适用边界与选择方法。
概述
集成项目在进入平台配置前，需要先选择合适的对接方式。平台提供三类对接方式：预制连接器、项目化连接器和 HTTP 组件。选择的核心目标是优先复用平台已有能力，减少重复开发。
核心概念
三类对接方式的定位如下：
| 方式 | 定位 |
|---|---|
| 预制连接器 | 平台已上架、可直接配置使用的连接器 |
| 项目化连接器 | 基于项目或高频系统需求，通过连接器开发工具沉淀的连接器 |
| HTTP 组件 | 通过 HTTP 接口直接调用对方系统的通用组件 |
总体原则
集成项目应优先选择平台已有能力，尽量减少重复开发。
推荐选择顺序如下：
优先使用预制连接器。无预制连接器时，判断是否具备标准接口和接口说明文档。具备标准接口且有复用价值，优先项目化连接器开发；具备标准接口但复用价值较低，可用 HTTP 组件直接调用。不具备接口条件时，需先推动客户侧接口建设或重新评估方案。。
对接方式选择表
| 判断条件 | 推荐方式 | 说明 |
|---|---|---|
| 平台已有预制连接器，且满足项目需求 | 预制连接器 | 优先使用，减少开发和适配成本 |
| 平台无预制连接器，但外部系统有标准接口，且具备复用价值 | 项目化连接器 | 使用连接器开发工具沉淀连接器能力 |
| 平台无预制连接器，但外部系统有接口文档，项目个性化较强或复用价值较低 | HTTP 组件 | 通过 HTTP 组件直接调用对方接口 |
| 外部系统无接口、无文档或接口不可调用 | 暂不建议直接进入配置 | 需先确认客户侧接口能力或推动接口建设 |
| 外部系统需要特殊协议、复杂鉴权或高复杂逻辑 | 技术评估后确定 | 可能需要研发支持或专项方案设计 |
三类方式说明
预制连接器
适用于平台已上架连接器，且客户系统接口标准、项目需求在连接器支持范围内的场景。。
适合：标准 SaaS 系统、有标准接口的私有化系统、平台已成熟连接器。
项目化连接器
适用于平台暂无预制连接器、但外部系统具备标准接口和完整接口文档，且后续有复用价值的场景。。
适合：新系统、高频系统、多项目可能复用的接口场景。
HTTP 组件
适用于平台暂无预制连接器、项目接口较个性化、复用价值暂不明确，但对方系统已具备可调用 HTTP API 的场景。。
适合：客户自建系统、单项目接口、轻量接口、快速验证。
不建议直接进入配置的情况
以下情况不建议直接进入平台配置：
- 外部系统没有开放接口
- 客户无法提供接口文档
- 接口返回结构不稳定
- 鉴权方式不明确
- 允许清单、网络、安全边界未确认
- 接口调用频率、限流、分页规则不明确
- 需要复杂私有协议
- 大量历史数据同步但接口不支持批量或分页
- 客户 IT 需先开发接口但责任和计划未确认
使用注意事项
不要扩大平台能力边界
不应默认认为所有系统都能自动打通，或没有接口也能直接集成。同样不应默认所有连接器都已成熟可用、AI 可自动完成集成项目、复杂逻辑无需研发支持、历史数据都能无风险同步。。
标准能力可以复用。个性化需求需结合客户接口能力、业务规则和安全要求进行评估。。
预制连接器优先使用
对于平台已有且成熟的连接器，新项目应优先使用系统集成平台交付。当前重点包括金蝶云星空、飞书多维表格，以及其他已成熟并完成项目验证的连接器。
标准接口是项目化交付的前提
无论使用项目化连接器还是 HTTP 组件，外部系统都需要具备接口基础。至少应具备接口地址、请求方式、鉴权方式、请求参数、响应结构、错误码、字段说明和测试环境。。
复杂场景需要先设计再配置
多系统串联、多分支判断、大批量历史数据、多组织多租户等场景，应先完成集成流设计和技术评估，再进入平台配置。强安全、高实时性、多接口事务一致、失败补偿复杂、客户接口不稳定等场景同理。。
所有待确认事项必须显式记录
常见待确认事项包括接口是否具备、接口由谁提供、鉴权方式、允许清单和字段映射。此外还有历史数据范围、同步频率、失败重试规则、异常通知人、人工补偿路径、上线时间和运维责任方。。