实体服务调用 API 总览

实体服务调用是第三方应用向物理或虚拟实体下发控制指令（反控 / 下行调用）的统一通道。DTS 支持在产品模型（Profile）中定义服务，并通过本接口以多种协议下发执行。

调用方式选择

DTS 提供了三种下行服务调用通道： 1. HTTP 协议下行：适用于直接使用标准 REST 接口反控直连设备的场景，网关会通过同步/异步方式返回执行状态。 2. 自定义 Topic 下行：适用于使用特定 MQTT Topic 订阅机制的场景，控制指令会封装为 Topic 载荷下发。 3. SDK 客户端下行：为具备集成 SDK 能力的网关或复杂微服务提供底层高性能的反控下行通信。

接口列表与导航

您可以点击下方超链接跳转到对应的接口开发说明：

接口名称 调用协议/方式 接口路径 适用说明
🌐 HTTP协议下行调用 HTTP /bv-microservice-digitaltwin-center/api/service/invoke 主流推荐。以同步/异步 HTTP 请求触发产品服务下行
🏷️ 自定义Topic下行调用 MQTT / HTTP /bv-universal-gateway/api/accessGateway/customDownlink 自定义 MQTT Topic 场景。以特定 Topic 格式投递指令报文
💻 SDK下行调用 SDK / HTTP /bv-microservice-digitaltwin-center/api/service/sdkInvoke 集成大视景二次开发 SDK 时使用的下行反控控制接口
作者：北京-产品-yantings  创建时间：2025-03-06 14:11
最后编辑：北京-产品-yantings  更新时间：2026-07-07 18:14
上一篇：
下一篇：