对接知识库

HTTP/HTTPS协议

作为第三方集成最基础的通信协议，通过请求-响应模式实现简道云与外部系统的数据交互。

• HTTP为明文传输，适用于非敏感数据
• HTTPS基于SSL/TLS加密，适用于财务、海关等敏感数据场景
• 配置人员无需理解加密细节，开发人员需掌握请求头构造、参数编码等细节

MQTT/OPC UA/LoRaWAN协议

适用于IoT设备、实时数据同步场景的通信协议。

• MQTT：轻量级发布/订阅协议，适用于车间机床数据采集
• OPC UA：工业控制系统专属标准化协议，支持复杂工艺参数传输
• LoRaWAN：低功耗广域网协议，适用于远距离、分散式IoT设备场景

核心认证方式

• AppID/Secret认证：第三方平台为开发者分配唯一标识与密钥，通过密钥计算签名或获取访问令牌
• OAuth2.0认证：授权码模式，适用于需用户授权的场景，核心流程为"简道云请求授权码→通过授权码获取访问令牌→通过令牌调用API"
• IP白名单+密钥认证：高安全级场景采用的双重认证机制，仅允许指定IP访问，同时通过密钥验证请求来源

数据安全防护

• 签名验证：通过对请求参数与密钥进行哈希计算，生成签名串，第三方系统验证签名一致性以确认数据未被篡改
• 数据加密：敏感数据传输前需加密，对称加密（AES）适用于大量数据加密，非对称加密（RSA）适用于密钥传输
• 最小权限原则：从权限设计层面降低安全风险，集成时仅申请必要权限

单向集成vs双向集成

• 单向集成：数据从第三方系统→简道云或简道云→第三方系统，架构简单，仅需单方向请求与数据解析
• 双向集成：数据双向同步，需设计数据一致性机制，避免数据冲突

无代码/低代码集成架构

• 无代码集成：基于简道云+集简云可视化工具，底层封装协议、认证、数据解析逻辑
• 低代码集成：针对非标准化API、复杂逻辑场景，开发人员通过代码扩展实现定制化集成