先记住这两条

查询数据使用 GET；修改数据使用 POST。 密钥不要放在 URL，推荐放在 Authorization: Bearer 你的密钥 请求头。

网页管理后台不需要手写 API。访问 /panel，输入密钥登录后即可直接修改状态、设备和隐私模式。

公开读取接口

数据修改接口

Windows PowerShell 上报示例

$secret = "填入 .env 中的 ALIVE_SECRET"
$headers = @{ Authorization = "Bearer $secret" }
$body = @{
  id = "windows-test"
  show_name = "Windows 测试机"
  using = $true
  status = "PowerShell"
} | ConvertTo-Json

Invoke-RestMethod `
  -Method Post `
  -Uri "http://localhost:9010/api/device/set" `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

Windows 客户端关闭行为

Ctrl+C 最可靠：脚本会先上报“未使用”，然后退出。

直接关闭 PowerShell 或 Windows Terminal 页面时，脚本也会监听关闭事件并尝试上报，但操作系统可能直接终止子进程，因此不能保证请求一定发完。

Alive 还有服务端兜底：客户端每 60 秒发送心跳；连续 150 秒没有任何上报，设备会自动变成“未使用”。可通过 status.device_timeout 调整。

密钥安全

Alive 只使用一个全局密钥，后台和所有设备客户端共同使用。最低 6 位，不需要为每台设备设置不同密码；正式部署仍建议使用更长的随机值。

不要使用 ?secret=xxx。查询字符串可能进入浏览器历史、代理日志、服务器日志和监控系统，Alive 会拒绝这种认证方式。

推荐 Bearer 请求头。网页后台登录成功后使用签名的 HttpOnly Cookie，Cookie 中不包含原始密钥。