HTTP协议实体接入(透传/自定义)

本文档详细介绍第三方应用采用HTTP协议、以透传/自定义数据格式进行实体接入的所需的API，明确接入要求、操作步骤及关键注意事项，助力开发者高效完成设备接入与数据上报对接。

适用场景

此流程仅适用于第三方应用采用HTTP协议发送透传/自定义 格式与DTS数字孪生系统进行上行数据上报的场景。

本接入方式适用于第三方平台或设备通过HTTP协议，向DTS数字孪生系统上报上行数据的场景，上报数据可包括传感器采集数据、设备运行状态信息、环境监测数据等各类实体相关数据。上报时，第三方平台或设备无需提前转换数据格式，可直接将自身原生数据发送至DTS通用网关服务，该服务将同步完成数据解析、身份合法性验证、请求参数识别等核心操作，随后由DTS系统对接收的数据根据消息解析脚本进行进一步处理、存储，确保数据正常接入。

注意事项

• 其他协议接入说明 ：若需采用除HTTP协议外的其他协议进行实体接入，请联系大视景科技技术对接人员，由双方配合完成对应协议的网关适配与开发工作。

• API选择规范：需严格按照产品配置的数据格式，选择对应的HTTP接入API，避免因API选择错误导致接入失败。

• 数据格式转换：透传/自定义格式数据必须通过消息解析脚本转为BV JSON格式，确保DTS系统可正常解析。

• 标识符管理：属性/事件的唯一标识符需提前规划、统一规范，避免标识符重复或缺失，影响请求识别与数据解析。

• 网关关联要求：产品必须关联至DTS通用网关，否则无法完成数据传输与上报。

Apifox 接口分享：https://apifox.com/apidoc/shared-2d55794d-55ae-43c8-b89a-3526536d2e35