保姆级教程：用ApiPost抓取德业除湿机API，5分钟搞定HomeAssistant的MQTT配置-洪萨配资

智能家居新手指南：5分钟用ApiPost实现德业除湿机MQTT接入HomeAssistant

第一次接触智能家居设备接入时，看到API、token、MQTT这些专业术语，很多人都会感到无从下手。其实只要选对工具，整个过程可以变得非常简单。本文将使用中文界面的ApiPost工具，带你一步步完成德业除湿机接入HomeAssistant的全过程，即使没有任何编程基础也能轻松掌握。

1. 准备工作与环境搭建

在开始之前，我们需要准备好必要的工具和环境。首先确保你已经拥有一台德业除湿机，并且已经在手机上下载安装了德业智能APP并完成设备绑定。这是后续操作的基础。

所需工具清单：

ApiPost（中文界面API调试工具，下载地址：www.apipost.cn）
HomeAssistant（建议使用2023年以后的版本）
文本编辑器（用于修改configuration.yaml文件）

安装ApiPost后，你会看到一个非常直观的中文界面。与Postman等英文工具相比，ApiPost对中文用户更加友好，所有菜单和提示都是中文显示，这大大降低了学习成本。工具左侧是请求历史记录区，中间是请求构建区，右侧是响应展示区，整体布局清晰合理。

2. 获取设备认证信息

接入云端设备的第一步是获取必要的认证信息。德业除湿机使用标准的OAuth2.0认证流程，我们需要通过API获取token和clientid。

2.1 登录获取token

在ApiPost中新建一个POST请求，填写以下信息：

POST https://api.deye.com.cn/v3/enduser/login/ Content-Type: application/json { "loginname": "你的德业APP账号", "password": "你的德业APP密码", "appid": "1.0.0", "extend": "{\"cid\":\"111111122223333\",\"type\":\"0\"}" }

发送请求后，你会得到一个JSON格式的响应，其中包含两个关键信息：

{ "data": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "clientid": "client_123456789" } }

提示：请妥善保存这个token和clientid，它们相当于设备的"身份证"和"钥匙"，后续所有操作都需要使用。

2.2 获取设备列表

有了token之后，我们就可以查询账户下绑定的设备了。新建一个GET请求：

GET https://api.deye.com.cn/v3/enduser/deviceList/ Authorization: jwt eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

响应中将包含设备的关键信息：

{ "data": [{ "product_id": "p123456789", "device_id": "d987654321", "product_name": "DYD-T22A3" }] }

记录下product_id和device_id，这两个值在MQTT配置中会用到。

3. 配置MQTT连接信息

MQTT是智能家居设备通信的核心协议，我们需要从德业云获取MQTT服务器的连接参数。

3.1 获取MQTT服务器信息

继续使用之前的token，发送GET请求：

GET https://api.deye.com.cn/v3/enduser/mqttInfo/ Authorization: jwt eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

响应中包含了完整的MQTT连接信息：

{ "data": { "loginname": "mqtt_user_123", "password": "mqtt_pass_456", "mqtthost": "xxxxxx.mqtt.iot.gz.baidubce.com", "mqttport": 1883, "endpoint": "ff7534ccae4711e7829100163e0f811e" } }

3.2 MQTT参数对照表

参数名称	说明	配置位置
mqtthost	MQTT服务器地址	HA的MQTT集成配置
mqttport	端口号(通常1883)	HA的MQTT集成配置
loginname	用户名	HA的MQTT集成配置
password	密码	HA的MQTT集成配置
endpoint	终端标识	switch配置中的topic
product_id	产品ID	switch配置中的topic
device_id	设备ID	switch配置中的topic

4. HomeAssistant配置实战

现在我们已经收集了所有必要的信息，可以开始在HomeAssistant中进行配置了。

4.1 配置MQTT集成

首先编辑configuration.yaml文件，添加MQTT基础配置：

mqtt: broker: xxxxxx.mqtt.iot.gz.baidubce.com port: 1883 username: mqtt_user_123 password: mqtt_pass_456 client_id: homeassistant_123

保存后，通过HomeAssistant的网页界面添加MQTT集成：

进入"配置" > "设备与服务"
点击右下角"添加集成"
搜索并选择"MQTT"
系统会自动检测到yaml中的配置，确认无误后完成添加

4.2 配置除湿机开关

继续在configuration.yaml中添加switch配置：

switch: - platform: mqtt name: "德业除湿机" unique_id: "deye_dehumidifier" state_topic: "ff7534ccae4711e7829100163e0f811e/p123456789/d987654321/status/hex" command_topic: "ff7534ccae4711e7829100163e0f811e/p123456789/d987654321/command/hex" state_on: "30" state_off: "20" value_template: "{{ value_json.data[5:7] }}" payload_on: "\x08\x02\x03\x20\x19\x00\x00\x00\x00\x00" payload_off: "\x08\x02\x02\x20\x19\x00\x00\x00\x00\x00"

关键参数说明：

state_topic和command_topic由endpoint、product_id和device_id拼接而成
payload_on和payload_off是控制设备开关的十六进制指令
value_template用于解析设备状态

5. 高级功能与自动化

基础配置完成后，我们可以进一步探索更高级的功能。

5.1 状态监控与反馈

除湿机接入后，你可以在HomeAssistant中看到设备的开关状态。如果需要更详细的信息监控，可以添加传感器配置：

sensor: - platform: mqtt name: "除湿机湿度" state_topic: "ff7534ccae4711e7829100163e0f811e/p123456789/d987654321/status/hex" value_template: "{{ value_json.data[9:11] | int(base=16) }}" unit_of_measurement: "%"

5.2 创建自动化规则

通过HomeAssistant的自动化功能，可以实现根据环境湿度自动控制除湿机：

automation: - alias: "高湿度自动开启除湿机" trigger: platform: numeric_state entity_id: sensor.living_room_humidity above: 65 action: - service: switch.turn_on target: entity_id: switch.deye_dehumidifier