15.1 客户端 SDK

TDengine IDMP SDK 提供对完整数据资产的编程访问：元素、属性、时序指标和事件。SDK 根据 IDMP 的 OpenAPI 规范自动生成，原生支持 Java 和 Python。对于其他语言，可使用 OpenAPI 规范配合 OpenAPI Generator 生成任意受支持语言的客户端。

典型使用场景

从第三方系统批量读写元素属性数据
自动化创建和管理元素、指标和事件
将 IDMP 数据集成到自定义 BI 工具或数据平台
从 IDMP 事件触发外部自动化工作流
将工业上下文输送到 AI/ML 管道

即将推出

SDK 正式发布时，版本和兼容性信息将在此发布。请从涛思数据下载中心下载最新 SDK 包。

SDK 包内容

从涛思数据下载中心下载 SDK 包，其结构如下：

idmp-sdk-1.0.14.1/
  ├── idmp-v1.0.14.1.json    # OpenAPI 规范——用于为其他语言生成 SDK
  ├── idmp-java-sdk/              # Java SDK 源码和编译后的 JAR
  └── idmp-python-sdk/            # Python SDK 源码

为其他语言生成 SDK

若需要 Java 或 Python 以外的语言，可使用 OpenAPI Generator 配合随包附带的规范文件。

第一步——下载 OpenAPI Generator CLI：

wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.6.0/openapi-generator-cli-7.6.0.jar \
     -O openapi-generator-cli.jar

第二步——生成目标语言 SDK：

# 示例：生成 Go SDK
java -jar openapi-generator-cli.jar generate \
  -i idmp-v1.0.14.1.json \
  -g go \
  -o idmp-go-sdk \
  --skip-validate-spec

将 -g go 替换为目标语言名称。受支持语言及可用选项请参见 OpenAPI Generator 文档。

📄️ 安装

前置条件

📄️ 快速开始

请先完成安装。本指南大约需要 5 分钟，带您完成第一次 API 调用。

📄️ 认证

IDMP SDK 使用 Bearer Token（JWT）进行认证。获取 Token 的方式取决于您的部署类型。

📄️ 核心概念

SDK 对象与 IDMP 产品概念一一对应。理解这些映射关系有助于快速找到所需的 API。

🗃️ API 参考

3 个项目

🗃️ 示例

2 个项目

📄️ 错误处理

异常类型

📄️ 变更日志

本页记录 TDengine IDMP SDK 各版本的变更内容。版本格式遵循语义化版本规范，变更类型遵循 Keep a Changelog 格式。

典型使用场景​

SDK 包内容​

为其他语言生成 SDK​