系统集成的API分类
系统提供三种不同的集成方式,用于满足不同的业务场景与对接复杂度。
三种集成方式一览
| 集成方式 | 核心特点 | 适用场景 | 对应文档 |
|---|---|---|---|
| 自动方案集成 | 依赖系统中预先配置的“签章方案”,接口调用时只需指定 plan_id |
签章规则固定、希望业务系统对接最简单、签章效果由平台统一维护 | 自动方案集成(APIntergration.md) |
| 自由签章集成 | 不依赖方案;接口直接上传文件与印章清单(stamps),由调用方决定每个印章的类型/位置/证书等 | 需要高度灵活的签章(动态印章、动态位置、不同证书策略),调用方有能力组织复杂参数 | 自由签章集成(RawSignApi.md) |
| 手动签章集成 | 不依赖方案;接口上传文件并指定签署人,在系统内发起“待签署任务”并由人工完成 | 需要把签章动作交给人工(审批/签署人操作),或需要人工确认后再签 | 手动签章集成(ManualSignApi.md) |
如何选择
1) 优先选:自动方案集成
当你们的签章版式、位置规则、骑缝章逻辑、签章图片/证书来源等都相对固定时,建议优先使用自动方案集成:
- 对接参数最少
- 业务系统改动最小
- 规则调整可以在平台侧配置完成
2) 需要完全自定义:自由签章集成
当你们每次调用都要动态决定“盖哪些章、盖在哪里、用哪个证书、盖在哪些页”等,或需要一次请求中组合多种类型印章时,使用自由签章集成。
3) 需要人工介入:手动签章集成
当签章需要人工确认/人工签署(例如某个签署人登陆系统操作),或希望通过接口“发起任务”而不是立即生成签章结果时,使用手动签章集成。