使用 Shelly 脚本通过身份验证控制 Shelly 设备

本文介绍了如何使用 Shelly 脚本通过身份验证来控制另一个 Shelly 设备。由于 Shelly.call(“http.get”) 方法无法将 URL 中的用户名和密码转换为 HTTP 认证头部，我们需要使用 HTTP.Request 方法，并手动生成 Authorization: Basic 头部来实现身份验证。文章提供了详细的代码示例，展示了如何构建带有身份验证信息的 HTTP 请求，并处理请求结果。

通过 HTTP.Request 进行身份验证

直接在 URL 中包含用户名和密码的方式 (http://USERNAME:PASSWORD@IP/relay/0?turn=on&timer=10) 并不总是有效，尤其是在 Shelly 的 Shelly.call(“http.get”) 方法中。更可靠的方法是使用 HTTP.Request，并手动添加 Authorization: Basic 头部。

以下是一个示例脚本，展示了如何使用 HTTP.Request 方法来控制需要身份验证的 Shelly 设备：

let CONFIG = {   host: "your_shelly_ip_or_hostname", // 目标 Shelly 设备的 IP 地址或主机名   username: "your_username",          // 目标 Shelly 设备的用户名   password: "your_password",          // 目标 Shelly 设备的密码   duration: 10                       // 开关持续时间，单位秒 };  function turnOnShelly() {   let shelly_url = "http://" + CONFIG.host + "/relay/0?turn=on&timer=" + CONFIG.duration;   let user_pass = btoa(CONFIG.username + ":" + CONFIG.password); // 将用户名和密码编码为 Base64 字符串    let header = {     method: "GET",     url: shelly_url,     headers: {},     timeout: 20,   };    if (CONFIG.username) {     header.headers.Authorization = "Basic " + user_pass; // 添加 Authorization 头部   }    print("Calling URL ", shelly_url);    Shelly.call("HTTP.Request", header, function (result, error_code, error_message) {     if (error_code === 200) {       print("Success: " + JSON.stringify(result));     } else {       print("Error code: " + error_code);       print("Errormessage: " + error_message);     }   }, null); }  // 调用 turnOnShelly 函数来打开 Shelly 设备 turnOnShelly();

代码解释：

1. CONFIG 对象： 包含了目标 Shelly 设备的 IP 地址/主机名、用户名、密码和开关持续时间。请务必替换为实际的值。
2. btoa() 函数： JavaScript 内置函数，用于将字符串编码为 Base64 字符串。我们将用户名和密码用冒号连接起来，然后进行 Base64 编码，得到 Authorization 头部所需的值。
3. header 对象： 定义了 HTTP 请求的各个属性，包括：
   • method: 请求方法，这里使用 GET。
   • url: 请求的 URL，包含了目标 Shelly 设备的 IP 地址和开关指令。
   • headers: 请求头，我们在这里添加 Authorization 头部。
   • timeout: 请求超时时间，单位秒。
4. Shelly.call(“HTTP.Request”, …)： 调用 Shelly 的 HTTP.Request 方法发送 HTTP 请求。
   • 第一个参数是 header 对象，包含了请求的详细信息。
   • 第二个参数是一个回调函数，用于处理请求结果。
     • result: 请求返回的结果。
     • error_code: 错误代码。200 表示成功。
     • error_message: 错误信息。
   • 第三个参数是 null，表示没有额外的数据传递给回调函数。

使用步骤：

1. 替换配置信息： 将 CONFIG 对象中的 host、username 和 password 替换为目标 Shelly 设备的实际值。
2. 保存脚本： 将代码保存为 .js 文件，例如 turn_on_shelly.js。
3. 上传到 Shelly 设备： 将脚本上传到 Shelly Plus 1 PM 设备上。
4. 运行脚本： 在 Shelly 设备的 Web 界面或通过 API 运行该脚本。

注意事项：

• 确保目标 Shelly 设备已启用身份验证，并且用户名和密码正确。
• btoa() 函数在某些情况下可能无法正确处理非 ASCII 字符。如果用户名或密码包含特殊字符，可能需要进行额外的编码处理。
• 仔细检查 Shelly 设备的日志输出，以便诊断任何问题。

总结：

通过使用 HTTP.Request 方法，并手动添加 Authorization: Basic 头部，我们可以轻松地通过身份验证来控制 Shelly 设备。这种方法比直接在 URL 中包含用户名和密码更安全、更可靠。希望本教程能帮助你成功地使用 Shelly 脚本控制其他 Shelly 设备。