概述

数字孪生服务 DTService(以下简称DTS)是通过数字孪生模型来模拟和管理现实世界的物理对象、系统或过程的服务，为数字孪生世界提供实时数据采集、分析与预测等功能，实现数字虚拟世界与物理世界的深度融合，帮助组织、企业或机构优化运营、提高效率、减少成本。
BV数字孪生服务可以支持在物理对象对应的实体概念中而不是具体的传感器中查询数据，此服务用于构建可重用、高度可扩展、具有空间感知的体验，以便跨数字世界和物理世界、社交世界将流式处理数据链接到一起。用户可以通过这些独有的相关上下文能力来增强各类上层应用。

DTS API可帮助您完成实体的接入注册和获取实体数据等功能。

使用DTS API 完成以下操作:

• 实体接入
• 获取实体属性
• 删除实体
• 实体服务调用
• 创建孪生体
• 获取孪生体信息
• 删除孪生体
• 执行任务
• 订阅资源流转

身份认证

为了对发送到DTS API 的请求进行身份验证，DTS 支持 HTTP 基本认证。请使用您的 API Key作为身份认证的密码。您可以通过 在通用用户系统中创建 API Key。

获取API Key

登录通用用户系统，进入“授权验证”模块。选择添加一个API Key，授予这个API Key与DTS相关的操作权限。生成的API Key需在进行请求HTTP接口调用时携带。

创建API Key

获取API Key

示例

 curl --location --request POST 'http://Host/bv-microservice-digitaltwin-center/api/entity/attribute' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'bv-api-key: YOUR_API_KEY' \
--header 'Accept: */*' \

获取订阅资源

1. 登录DTS，进入【订阅管理】模块，选择【订阅者列表】功能，进入订阅者中心；
2. 选择【创建订阅者】功能，手动输入或自动生成应用appSecret，输入订阅者名称，可选择输入订阅者描述文字，选择【确定】，创建订阅者；
3. 创建成功后，选择对应的订阅者，选择【查看】，进入订阅者详情页，获取appID（AK）和appSecret（SK）。

使用订阅资源流转相关API时需要。

API 规则