语音提醒：怎么把30W HTTP 接口语音音柱对接到自己的项目中_解决方案

CATALOG

芯步30W音柱的HTTP接口挺简洁的——核心就是签个名、发个POST请求。下面从接口原理、签名算法到各语言代码示例都过一遍，你照着复制改改参数就能跑起来。

一、开篇：这是个啥玩意儿？

简单说，芯步的这款30W音柱就是个连了WiFi的“大嗓门”。它最大的好处是，你不需要像以前那样去录音、导文件、存进SD卡。

你只需要给你的程序（不管是Java后端、PHP网站，还是Python脚本）发个指令，告诉它：“给那个叫XXX的音柱说一句话”，它就能立刻用很自然的人声给你喊出来。

这篇文章主要针对 30W 智能语音音柱（当然，接口逻辑基本通用），手把手教你把它喊通。

二、核心准备：开干前的“户口本”

在写代码之前，你得先去芯步的开发者后台拿到两样东西，这就相当于你家里的钥匙：

AppID：你的“账号ID”，标识你是谁。
AppSecret：你的“密码”，千万别泄露到网页前端代码里。
Device ID：你这台音柱的编号。就像你要打电话，得有对方手机号一样。

三、接口原理：其实就一句话的事

接口地址（看这个长相就行，不用急着复制）：https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

核心玩法是这样的：为了防止别人乱敲你的音柱，每次发请求必须带一个动态密码（sign）。这个密码是根据 AppSecret 和当前时间 ts 算出来的。

签名算法（重点，敲黑板）：sign = md5( md5(AppSecret) + ts )

翻译成人话就是

先把你的 AppSecret 进行一次MD5加密。
把上面得到的结果，拼接上当前的时间戳（比如 1747212640）。
再把拼接好的这串字符，整体再做一次MD5加密。

请求参数（Body）：

device：传你的设备ID。
order：这是一个JSON字符串，告诉音柱要干嘛。比如播报文字：{"play:gbk:16":"你好，仓库发车了"}。

四、实战演练：语言代码示例

这里我挑三个最常见的场景给你写一下，逻辑一模一样，换一下参数就行。

第一种场景：Python （最灵活，适合各种脚本和后端）

第二种场景：Java （用Unirest或者OkHttp，这里用OkHttp演示）

import okhttp3.*;
import java.io.IOException;
import org.apache.commons.codec.digest.DigestUtils;

public class VoiceBroadcaster {
    public static void main(String[] args) {
        String appId = "你的AppID";
        String appSecret = "你的AppSecret";
        String deviceId = "你的设备ID";
        
        long ts = System.currentTimeMillis() / 1000;
        // 计算签名
        String firstMd5 = DigestUtils.md5Hex(appSecret);
        String sign = DigestUtils.md5Hex(firstMd5 + ts);
        
        String url = "https://api.thingboot.com/" + appId + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        OkHttpClient client = new OkHttpClient();
        
        // 构建JSON Body
        String json = "{\"device\":\"" + deviceId + "\"， \"order\": {\"play:gbk:16\": \"请注意，设备已就绪\"}}"；
        
        Request request = new Request.Builder()
            .url(url)
            .post(RequestBody.create(json, MediaType.parse("application/json")))
            .build();
            
        try (Response response = client.newCall(request).execute()) {
            System.out.println(response.body().string());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}