HTTP

HTTP 集成可以从 Macro Deck 发送 Web 请求。可以用它调用 Webhook、控制网络中带有 Web API 的设备，或者从在线服务读取一个值并显示在按键上。它随 Macro Deck 一同提供，并且一开始就处于启用状态，因此无需连接或登录任何东西。

两个动作

发送 HTTP 请求 可以构建完整的请求。选择 方法，输入 URL，并以名称和值的形式添加 查询参数 和 请求头。在 正文类型 中选择 none、json、form、text 或 multipart（带额外表单字段的文件上传）。身份验证 提供 basic（用户名和密码）、bearer（令牌）和 header（放在自定义名称的请求头中的令牌，例如 X-Api-Key）。预期状态 决定哪些响应算作成功，默认为 2xx。还可以设置 超时、关闭 跟随重定向，以及限制 响应大小上限（字节）。

捕获 会将响应的部分内容保存到变量中。每一行将一个变量名与一个选择器配对：$status、$ok、$duration、$body、$truncated、$headers、$header:<name>，或者一个 JSON 路径，例如 data.items[0].name。尚不存在的变量会被自动创建。

获取 JSON 值 是读取单个值的简便方式：输入 URL、JSON 路径，并在 保存到变量 中选择变量。

示例设置

• 一个按键，使用 发送 HTTP 请求 和正文类型 json，向聊天 Webhook 发送 {"text": "Stream is live"}。
• 一个按键，通过本地 Web API 打开网络中的智能插座。
• 一个按键，使用 获取 JSON 值 从公共 API 读取当前价格，并用 {{ vars.price }} 显示在其标签中。
• 一个流程，发送请求、捕获 $status，并在服务器未返回 200 时使用 如果 / 否则 将按键设为红色。

查询参数和请求头的值中可以包含变量，例如 {{ vars.channel }}。请求在运行 Macro Deck 的电脑上执行，因此 http://192.168.1.20 这样的地址可以访问该电脑所在网络中的设备。当服务器无法访问、请求超时、TLS 证书被拒绝或状态码与预期不符时，动作会失败并显示清晰的消息。