All Products
Search
Document Center

Time Series Database:Get SDK

Last Updated:Mar 28, 2026

The TSDB Java SDK (hitsdb-client) lets you interact with Time Series Database (TSDB) from Java applications. Before you start, read Terms and the HTTP API Reference to understand TSDB concepts and available APIs.

Prerequisites

Before you begin, ensure that you have:

  • A Java project with Maven or a manual dependency management setup

  • (Optional) Access to the Release Notes to confirm the latest SDK version

Add the SDK to your project

Choose the method that matches your build setup.

Method 1: Add a Maven dependency (recommended)

Add the following dependency to the <dependencies> section of your pom.xml:

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>hitsdb-client</artifactId>
    <version>{version}</version>
</dependency>

Replace {version} with the latest version number. See the Release Notes for the current version.

Method 2: Download JAR files manually

Use this method if your environment does not have access to Maven Central.

  1. Download the following dependency JAR files:

    LibraryVersionDownload
    httpasyncclient4.1.3httpasyncclient-4.1.3.jar
    httpclient4.5.3httpclient-4.5.3.jar
    httpcore4.4.6httpcore-4.4.6.jar
    httpcore-nio4.4.6httpcore-nio-4.4.6.jar
    fastjson1.2.35fastjson-1.2.35.jar
    slf4j-api1.7.21slf4j-api-1.7.21.jar
  2. Download the latest hitsdb-client JAR file from the Release Notes.

  3. Add all JAR files to your project's classpath and start development with the TSDB-Client SDK.

What's next

  • Read the [HTTP API Reference] to learn how to write and query time series data.

  • See the Release Notes for SDK changelog and version history.