验证设备 API
创建特定设备的远程控制令牌，并了解 ShareAI 设备 API 请求的提供者、设备和启用状态检查。
本页面内容
设备 API 作用于特定的提供者–设备关系。它是提供者远程访问之下的第二个访问层级。用于该设备的会话和共享命令。
启用两个层级#
- 在提供者设置中启用 远程访问.
- 打开目标设备及其 远程控制 标签。为该设备启用远程控制。
- 创建一个命名的设备访问令牌并存储其密钥。复制显示的提供者 UUID 和设备 UUID，用于相同的关系。
- 使用 HTTP Basic 进行身份验证：提供者 UUID 作为用户名，设备访问令牌作为密码。
访问边界#
| 检查 | 要求 |
|---|---|
| 提供者身份 | 基本用户名和路径提供者UUID必须与令牌的提供者匹配。 |
| 设备身份 | 路径设备UUID必须与令牌的设备关系匹配。 |
| 提供者访问 | 必须启用提供者远程访问。 |
| 设备访问 | 必须为此设备启用远程控制。 |
| 连接 | 关系必须是连接或共享的。 |
| 令牌状态 | 令牌必须处于活动状态。 |
通过读取验证#
GET
https://api.shareai.now/api/v1/console/provider/{provider_uuid}/device-management/{device_uuid}/remote/sessions读取授权设备的会话。
- 基础 URL
https://api.shareai.now- 身份验证
- HTTP Basic：提供者 UUID 和设备访问令牌
cURL
curl --fail-with-body \
"https://api.shareai.now/api/v1/console/provider/$PROVIDER_UUID/device-management/$DEVICE_UUID/remote/sessions?page=1&limit=20" \
-u "$PROVIDER_UUID:$DEVICE_ACCESS_TOKEN"
当请求被拒绝时#
检查两个启用的开关、当前连接、令牌状态以及两个UUID。不要使用设备名称、MAC地址、所有者邮箱或提供者级访问令牌作为替代。在重新连接设备后，重新检查Console中显示的关系。
最近更新于 9 月 15, 2026