GETPOST
v1.0.0stable获取设备信息
使用 Token 鉴权，通过 KID 或 UDID 查询设备详细信息。
GET | POST
/api/device/info认证:API Key
请求参数
所有请求参数需通过 Query 或 Body 传递
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 用户 API Token 示例: your_api_token_here |
kid | string | 可选 | 设备 KID，与 udid 二选一；推荐优先使用 KID 精确查询 示例: KID001 |
udid | string | 可选 | 设备 UDID，与 kid 二选一；同一 UDID 多证书时请改用 KID 示例: 00008030-001234567890002E |
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | number | 必填 | 状态码：1=成功，其他=失败 示例: 1 |
msg | string | 必填 | 返回信息 示例: 获取成功 |
data.kid | string | 必填 | 设备 KID 示例: KID001 |
data.udid | string | 必填 | 设备 UDID 示例: 00008030-001234567890002E |
data.pname | string | 必填 | 设备名称 示例: iPhone 15 Pro |
data.type | string | 必填 | 设备类型 示例: iphone |
data.zt | string | 必填 | 设备/证书状态 示例: normal |
data.ytime | number | 必填 | 会员到期时间戳，0 表示永久有效 示例: 1772267945 |
data.enabled | boolean | 必填 | 设备是否启用 示例: true |
data.beizhu | string | 必填 | 设备备注 示例: 主力设备 |
响应示例
{}
"code":1,
"msg":"获取成功",
"time":1769675945,
"data":
{}
,"kid":"KID001",
"udid":"00008030-001234567890002E",
"pname":"iPhone 15 Pro",
"type":"iphone",
"shtype":1,
"zt":"normal",
"ytime":1772267945,
"enabled":true,
"beizhu":"主力设备"
"ip":"192.168.1.100",
"ysucc":"Ysucc"
错误码
错误码4 个定义
12Token 不能为空
未提供 token 参数
20请提供 kid 或 udid
未提供设备标识
100设备不存在或无权限操作
设备不存在或不属于当前 token 用户
响应语言
通过 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/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002E" \
-H "X-Lang: zh"注意事项
- kid 和 udid 二选一；同一 UDID 存在多条证书记录时建议使用 KID 精确查询
- 该接口只能查询当前 token 用户名下的设备
- 返回字段可能随设备状态、证书状态和历史数据完整度不同而为空
在控制台试一试
填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态
https://testypro.iwai.cc/api/device/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002E已锁定本站string必填
用户 API Token
string
设备 KID，与 udid 二选一；推荐优先使用 KID 精确查询
string
设备 UDID，与 kid 二选一；同一 UDID 多证书时请改用 KID