HTTP 服务

开启本地 HTTP 接口,让其他程序或脚本控制 UDhold。

HTTP 服务是个进阶功能,开了之后别的程序(自动化脚本、Stream Deck、Raycast 这类工具)就能通过本地接口控制 UDhold,比如远程呼出搜索框、显示或隐藏窗口。呼出搜索框输入"HTTP 服务"打开。

开启

  1. 打开 HTTP 服务界面,开启"启用 HTTP 服务"
  2. 复制里面的 API 密钥
  3. 调用接口时带上这个密钥

默认地址是 http://127.0.0.1:36578,端口可以在设置里改。

能干什么

主要这几个接口:

接口作用
显示主窗口把 UDhold 搜索框呼出来,还能顺带填入搜索词
隐藏主窗口把搜索框收回去
切换显示/隐藏当前显示就隐藏,隐藏就显示

调用时在请求头带上密钥就行:

Authorization: Bearer <你的密钥>

安全

这个服务只监听本机(127.0.0.1),不会暴露到局域网或公网,别的电脑访问不到。密钥重新生成后,旧的立即失效。

适合谁用

如果你会用脚本或自动化工具,想把 UDhold 接进自己的工作流(比如按一下 Stream Deck 的按键就呼出 UDhold 并填入特定内容),这个功能就很有用。普通用户用不到的话保持关闭即可。