GETPOST
v1.0.0stable禁用/啟用設備
使用 Token 鑑權更新設備狀態
GET | POST
/api/device/status驗證:API Key
速率限制:60/分鐘
請求參數
所有請求參數需透過 Query 或 Body 傳遞
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
token | string | 必填 | 用戶 API Token 範例: your_api_token_here |
kid | string | 選填 | 設備 KID，與 udid 二選一 範例: ABC123XYZ |
udid | string | 選填 | 設備 UDID，與 kid 二選一 範例: 00008030-001234567890002E |
action | string | 選填 | 操作類型：enable=啟用，disable=禁用，toggle=切換。預設 toggle enabledisabletoggle 範例: disable |
回應參數
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
code | number | 必填 | 狀態碼：1=成功，其他=失敗 範例: 1 |
msg | string | 必填 | 返回訊息 範例: 设备已禁用 |
time | number | 必填 | 伺服器時間戳（Unix 秒） 範例: 1769675945 |
data | object | 必填 | 業務數據 |
data.id | number | 必填 | 設備 ID 範例: 12345 |
data.kid | string | 必填 | 設備 KID 範例: ABC123XYZ |
data.udid | string | 必填 | 設備 UDID 範例: 00008030-001234567890002E |
data.enabled | boolean | 必填 | 當前啟用狀態 範例: false |
data.yblack | string | 必填 | 狀態標識：Ysucc=啟用，Yno=禁用 範例: Yno |
data.status_name | string | 必填 | 狀態名稱 範例: 禁用 |
data.status_code | number | 必填 | 狀態碼：1=啟用，0=禁用 範例: 0 |
ip | string | 必填 | 請求者 IP 地址 範例: 192.168.1.100 |
ysucc | string | 必填 | 成功標識，成功時返回 "Ysucc" 範例: Ysucc |
回應示例
{}
"code":1,
"msg":"設備已禁用",
"time":1769675945,
"data":
{}
,"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"enabled":false,
"yblack":"Yno",
"status_name":"禁用",
"status_code":0
"ip":"192.168.1.100",
"ysucc":"Ysucc"
啟用設備
action=enable 啟用設備
啟用設備
{}
"code":1,
"msg":"設備已啟用",
"time":1769675945,
"data":
{}
,"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"enabled":true,
"yblack":"Ysucc",
"status_name":"启用",
"status_code":1
"ip":"192.168.1.100",
"ysucc":"Ysucc"
錯誤碼
錯誤碼7 個定義
12Token 不能為空
未提供 Token 參數
10Token 無效
Token 無效或已過期
20請提供 kid 或 udid
未提供 kid 或 udid
回應語言
透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。
建議請求標頭
X-Lang: zh-TW支援的語言
zh, en, zh-TW, vi, ar也可以使用 Accept-Language；X-Lang 優先級更高。不支援的語言將回退為英文。
程式碼示例
curl -X GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disable" \
-H "X-Lang: zh-TW"注意事項
- 當一個 udid 有多個證書時，需要使用 kid 精確指定
- 禁用後的設備將無法進行安裝操作
- 只能操作屬於自己的設備
在控制台試一試
在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。
https://testypro.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disable已鎖定本站string必填
用戶 API Token
string
設備 KID，與 udid 二選一
string
設備 UDID，與 kid 二選一
string
操作類型：enable=啟用，disable=禁用，toggle=切換。預設 toggle