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支持的语言
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"注意事项
- 当一个 udid 有多个证书时，需要使用 kid 精确指定
- 禁用后的设备将无法进行安装操作
- 只能操作属于自己的设备
在控制台试一试
填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态
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