15.1 Client SDK
The TDengine IDMP SDK gives you programmatic access to the full data asset: elements, attributes, time-series metrics, and events. The SDK is auto-generated from IDMP's OpenAPI specification and is natively available in Java and Python. For other languages, the OpenAPI spec can be used with OpenAPI Generator to produce a client in any supported language.
Typical Use Cases
- Bulk read or write element attribute data from third-party systems
- Automate creation and management of elements, metrics, and events
- Integrate IDMP data into custom BI tools or data platforms
- Trigger external automation workflows from IDMP events
- Feed industrial context into AI/ML pipelines
Version and compatibility information will be published here when the SDK reaches general availability. Download the latest SDK package from the TDengine Download Center.
SDK Package Contents
Download the SDK package from the TDengine Download Center. The package has the following structure:
idmp-sdk-1.0.14.1/
├── idmp-v1.0.14.1.json # OpenAPI spec — use this to generate SDKs for other languages
├── idmp-java-sdk/ # Java SDK source and compiled JAR
└── idmp-python-sdk/ # Python SDK source
Generating an SDK for Other Languages
If you need a language other than Java or Python, use OpenAPI Generator with the included spec file.
Step 1 — Download the 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
Step 2 — Generate the target language SDK:
# Example: generate a 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
Replace -g go with the target language name. See the OpenAPI Generator documentation for supported languages and available options.
📄️ Installation
Prerequisites
📄️ Quick Start
Complete Installation first. This guide takes about 5 minutes and walks you through your first API call.
📄️ Authentication
The IDMP SDK uses Bearer Token (JWT) for authentication. How you obtain a token depends on your deployment type.
📄️ Core Concepts
SDK objects map one-to-one with IDMP product concepts. Understanding these mappings helps you quickly locate the API you need.
🗃️ API Reference
3 items
🗃️ Examples
2 items
📄️ Error Handling
Exception Type
📄️ Changelog
This page records changes in each version of the TDengine IDMP SDK. Version numbering follows Semantic Versioning. Change categories follow the Keep a Changelog format.
