跳转至

系统集成的API分类

系统提供三种不同的集成方式,用于满足不同的业务场景与对接复杂度。

三种集成方式一览

集成方式 核心特点 适用场景 对应文档
自动方案集成 依赖系统中预先配置的“签章方案”,接口调用时只需指定 plan_id 签章规则固定、希望业务系统对接最简单、签章效果由平台统一维护 自动方案集成(APIntergration.md)
自由签章集成 不依赖方案;接口直接上传文件与印章清单(stamps),由调用方决定每个印章的类型/位置/证书等 需要高度灵活的签章(动态印章、动态位置、不同证书策略),调用方有能力组织复杂参数 自由签章集成(RawSignApi.md)
手动签章集成 不依赖方案;接口上传文件并指定签署人,在系统内发起“待签署任务”并由人工完成 需要把签章动作交给人工(审批/签署人操作),或需要人工确认后再签 手动签章集成(ManualSignApi.md)

如何选择

1) 优先选:自动方案集成

当你们的签章版式、位置规则、骑缝章逻辑、签章图片/证书来源等都相对固定时,建议优先使用自动方案集成:

  • 对接参数最少
  • 业务系统改动最小
  • 规则调整可以在平台侧配置完成

详见:自动方案集成(APIntergration.md)

2) 需要完全自定义:自由签章集成

当你们每次调用都要动态决定“盖哪些章、盖在哪里、用哪个证书、盖在哪些页”等,或需要一次请求中组合多种类型印章时,使用自由签章集成。

详见:自由签章集成(RawSignApi.md)

3) 需要人工介入:手动签章集成

当签章需要人工确认/人工签署(例如某个签署人登陆系统操作),或希望通过接口“发起任务”而不是立即生成签章结果时,使用手动签章集成。

详见:手动签章集成(ManualSignApi.md)