驗證裝置 API
創建一個針對設備嘅遠程控制令牌,並了解 ShareAI 設備API請求嘅提供者、設備同啟用狀態檢查。
喺呢頁面
設備API作用於特定嘅提供者–設備關係。呢係提供者遠程訪問之下嘅第二層訪問。用於該設備嘅會話同共享命令。
啟用兩層#
- 喺提供者設置中啟用 遠程訪問.
- 打開目標設備同其 遠程控制 標籤。為該設備啟用遠程控制。
- 創建一個命名嘅設備訪問令牌並存儲其密鑰。複製顯示嘅提供者UUID同設備UUID,用於相同嘅關係。
- 用HTTP Basic認證:用provider UUID作為用戶名,device access token作為密碼。


訪問邊界#
| 檢查 | 要求 |
|---|---|
| Provider身份 | Basic用戶名同路徑嘅provider UUID必須同token嘅provider相符。 |
| 裝置身份 | 路徑裝置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入面顯示嘅關係。
最後更新日期:2026年9月15日