iS3交付材料

用户392

用户2866

2024年8月21日修改

1.
iS3数字城建造器​

2.
iS3二次开发包​

2.1
产品介绍​

iS3二次开发包包括孪生场景预览服务、孪生体服务、数据集服务、场景可视化与交互服务等服务，帮助用户构建具有服务能力的数字孪生系统，以用于现实场景的及时表达和支撑业务应用的后续搭建。​

2.2
API参考​

2.2.1
使用前必读​

iS3二次开发包提供了REST（Representational State Transfer）风格API，支持您通过HTTP请求调用，调用方法请参见如何调用API。

同时iS3开发包还提供多种编程语言的SDK供您使用，SDK的使用方法请参见如何调用SDK。

2.2.2
API概览​

•
孪生场景预览服务​

API

说明

网页应用服务，打开浏览器输入地址即可访问

•
孪生体服务​

API

说明

返回场景中所有的孪生对象组信息，包括孪生对象code、name等属性​

返回对象组中所有对象实例信息，包括对象实例的code、name等属性​

返回对象组中所有子属性code(subCode)

返回对象对象组的关联子属性数据信息

•
数据集服务​

API

说明

返回对应数据字典的元数据（时序、非时序）

2.2.3
如何调用API​

2.2.3.1
申请账号​

申请iS3平台的租户和用户账号，并成功登录iS3数字在线页面

2.2.3.2
认证鉴权​

调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。​

•
Token认证（动态令牌校验）：通过Token认证通用请求。适用于前端用户登录场景，是通过账号密码登录后，获取token信息，从而进行校验的方式​

•

AK/SK认证（静态令牌校验）：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。适用于分析服务和应用等后端自动访问接口的场景，可通过如下方式获取：

◦
点击右上角 AK/SK管理​

◦
可以选择一个已有的，复制获得AK SK信息​

◦
或点击新增，输入该令牌的名称和描述信息，新增一个访问令牌​

2.2.3.3
调用API​

iS3交付材料​