如何用Java语言对接20A 智能通断器

2026-03-14 发布浏览：94 次

本文介绍了如何用 Java 对接智能通断器AC4-20A 的方法：可以通过接口实现单路交流负载控制、远程定时任务控制、自定义联动逻辑控制、线路状态反馈控制、按钮动作屏蔽控制、20A 额定电流控制、4400W 额定功率控制、远程通断控制、过流过载保护控制、过压欠压保护控制、短路保护控制、远程开关状态查询、场景联动控制、远程批量控制、故障告警通知、过流自动断电控制、延时通断控制、设备运行状态监控、远程参数配置管理、多设备联动控制、HTTP 接口远程通断控制、10A 额定电流控制、2200W 额定功率控制、实时能耗计量控制、用电数据上传控制、能耗数据统计控制、用电异常告警、功率超限保护、漏电保护控制、异常断电记忆恢复。

智能通断器AC4-20A

总额定功率4400W；

按钮动作可自定义、可屏蔽；

HTTP接口远程控制通断；

支持远程定时任务，支持自定义联动操作；

更多...

适用场景

智能家居照明设备控制、共享场所交流负载管理、智能办公交流电路控制、安全节能交流设备管理、普通灯具系统交流控制、家电设备电源管理、安防设备交流电路控制、物联网设备交流供电管理、实验室交流负载控制、自动化设备交流电源管理、共享自习室灯光电源控制、共享茶室照明插座控制、共享棋牌室灯光设备控制、共享桌游室灯光空调控制、共享麻将馆灯光插座管理、自助洗车机电路控制、自助售货机电源管理、自助打印机电源控制、自助充电桩线路控制、自助洗衣设备电源管理、共享健身房灯光设备控制、共享球场灯光电源控制、共享场馆照明系统控制、商业店铺灯光电源管理、办公设备交流电路控制、仓储设备电源控制、酒店客房照明控制、商场展柜电路保护、社区公共设备控制、广告灯箱电路控制、景观亮化工程电源管理、图书馆阅览室电源管理、咖啡厅电器回路保护、便利店收银机电源管理、药店冷藏柜电源控制、共享按摩椅电源控制、自动贩卖机电路管理、充电桩辅助电源控制、智慧工厂产线设备控制、校园公共设备电源管理中

支持命令

线路	power
先通后断	point
先断后通	reset

产品手册

版本	对应产品手册
白色	《智能通断器4-20A产品手册》

HTTP接口控制以设备控制（向设备下发命令）为例

// First you need to prepare the following values
// 1. AppID (in your console development settings)
// 2. AppSecret (in your console development settings)
// 3. ts (timestamp of the current time, seconds)
// 4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
// In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
// Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
// Request needs to pass two parameters device and order:
// device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
// order[json string]: the command to be issued, for example:
// {"power":1}, usually to connect the circuit of the switch
// {"power3":0}, usually to close the third line of the switch or controller
// {"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
// The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
// Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command

/*首先，确保在你的项目中添加了 unirest 的 Maven 依赖。如果你使用的是 Maven，可以在 pom.xml 中添加以下依赖：
<dependency>
    <groupId>com.konghq</groupId>
    <artifactId>unirest-java</artifactId>
    <version>3.13.10</version>
</dependency>
*/

import com.konghq.unirest.http.HttpResponse;
import com.konghq.unirest.http.Unirest;
import com.konghq.unirest.http.exceptions.UnirestException;
import org.apache.commons.codec.digest.DigestUtils;

public class Main {
    public static void main(String[] args) {
        // 定义变量
        String AppID = "开发者ID"; // 替换为实际的 AppID
        String AppSecret = "开发者密码"; // 替换为实际的 AppSecret
        long ts = System.currentTimeMillis() / 1000; // 获取当前时间戳（秒）

        // 计算签名 md5(md5(开发者密码)拼接上面的ts参数)
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);

        // 构建 URL
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", AppID, sign, ts);

        // 请求体数据
        String device = "1878"; // 替换为实际的设备ID；可传多个[用,间隔]
        String order = "{\"power1\":1}"; // 替换为实际的命令

        try {
            // 构建请求体
            String postData = String.format("{\"device\":\"%s\",\"order\":%s}", device, order);

            // 发送 POST 请求
            HttpResponse<String> response = Unirest.post(url)
                    .header("Content-Type", "application/json")
                    .body(postData)
                    .asString();

            // 输出响应
            System.out.println(response.getBody());
        } catch (UnirestException e) {
            e.printStackTrace();
        }
    }
}

// First you need to prepare the following values
// 1. AppID (in your console development settings)
// 2. AppSecret (in your console development settings)
// 3. ts (timestamp of the current time, seconds)
// 4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
// In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
// Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
// Request needs to pass two parameters device and order:
// device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
// order[json string]: the command to be issued, for example:
// {"power":1}, usually to connect the circuit of the switch
// {"power3":0}, usually to close the third line of the switch or controller
// {"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
// The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
// Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command

/*
首先，确保在你的项目中添加了 OkHttp 的 Maven 依赖。如果你使用的是 Maven，可以在 pom.xml 中添加以下依赖：
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.3</version>
</dependency>
*/

import okhttp3.*;
import org.apache.commons.codec.digest.DigestUtils;

import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        // 定义变量
        String AppID = "开发者ID"; // 替换为实际的 AppID
        String AppSecret = "开发者密码"; // 替换为实际的 AppSecret
        long ts = System.currentTimeMillis() / 1000; // 获取当前时间戳（秒）

        // 计算签名 md5(md5(开发者密码)拼接上面的ts参数)
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);

        // 构建 URL
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", AppID, sign, ts);

        // 请求体数据
        String device = "1878"; // 替换为实际的设备ID；可传多个[用,间隔]
        String order = "{\"power1\":1}"; // 替换为实际的命令

        // 构建请求体
        String postData = String.format("{\"device\":\"%s\",\"order\":%s}", device, order);

        // 创建 OkHttpClient 实例
        OkHttpClient client = new OkHttpClient();

        // 创建请求体
        MediaType mediaType = MediaType.parse("application/json; charset=utf-8");
        RequestBody body = RequestBody.create(postData, mediaType);

        // 创建请求
        Request request = new Request.Builder()
                .url(url)
                .post(body)
                .addHeader("Content-Type", "application/json")
                .build();

        // 发送请求并处理响应
        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);

            // 输出响应
            System.out.println(response.body().string());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

说明：{AppID}为您的应用ID（由平台生成），免费注册登录后，可在控制台查看；sign和ts的取值，请参考文档。