返回首页API 文档
语言: 简体中文
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
返回文档列表
GETPOST
v1.0.0stable

获取设备列表

使用 Token 鉴权查询当前用户设备列表，支持分页和状态筛选。

GET | POST/api/device/list
认证:API Key

请求参数

所有请求参数需通过 Query 或 Body 传递

参数名类型必填说明
token
string必填
用户 API Token
示例: your_api_token_here
page
number可选
页码，默认 1
示例: 1
per_page
number可选
每页数量，默认 20，最大 100
示例: 20
zt
string可选
状态筛选：all=全部，normal=正常，hidden=掉签/封禁，reviewing=审核中，update=待更新
allnormalhiddenreviewingupdate
示例: all
shtype
string可选
售后类型筛选，多个值用英文逗号分隔
示例: 1,2

响应参数

参数名类型必填说明
code
number必填
状态码：1=成功，其他=失败
示例: 1
msg
string必填
返回信息
示例: 获取成功
data.devices
array必填
设备列表
data.devices[].kid
string必填
设备 KID
示例: KID001
data.devices[].udid
string必填
设备 UDID
示例: 00008030-001234567890002E
data.devices[].pname
string必填
设备名称
示例: iPhone 15 Pro
data.devices[].zt
string必填
设备/证书状态
示例: normal
data.devices[].ytime
number必填
会员到期时间戳，0 表示永久有效
示例: 1772267945
data.devices[].enabled
boolean必填
设备是否启用
示例: true
data.total
number必填
匹配设备总数
示例: 36
data.page
number必填
当前页码
示例: 1
data.per_page
number必填
实际每页数量，最大 100
示例: 20
data.last_page
number必填
最后一页页码
示例: 2
data.count_normal
number必填
正常设备数量
示例: 30
data.count_hidden
number必填
掉签/封禁设备数量
示例: 4
data.count_reviewing
number必填
审核中设备数量
示例: 2
响应示例
{
"code":1,
"msg":"获取成功",
"time":1769675945,
"data":
{
"devices":
[
{
"kid":"KID001",
"udid":"00008030-001234567890002E",
"pname":"iPhone 15 Pro",
"type":"iphone",
"shtype":1,
"zt":"normal",
"ytime":1772267945,
"model":"iPhone16,1",
"beizhu":"主力设备",
"enabled":true
}
]
,
"total":36,
"page":1,
"per_page":20,
"last_page":2,
"count_normal":30,
"count_hidden":4,
"count_reviewing":2
}
,
"ip":"192.168.1.100",
"ysucc":"Ysucc"
}

查询第一页设备

获取当前用户前 20 台设备

查询第一页设备
{
"token":"your_api_token_here",
"page":1,
"per_page":20
}

只查询正常设备

zt=normal 仅返回正常可用设备

只查询正常设备
{
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
}

查询审核中设备

zt=reviewing 返回仍在审核/预约中的设备

查询审核中设备
{
"token":"your_api_token_here",
"zt":"reviewing"
}

每页最多返回100条

per_page 超过 100 时后端会自动按 100 处理

每页最多返回100条
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

错误码

错误码2 个定义
12
Token 不能为空
未提供 token 参数
10
Token 无效
token 不存在或用户状态不允许访问

响应语言

通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。

推荐请求头
X-Lang: zh
支持的语言
zh, en, zh-TW, vi, ar

也可以使用 Accept-Language；X-Lang 优先级更高。不支持的语言将回退为英文。

代码示例

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
  -H "X-Lang: zh" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2"

注意事项

  • 列表只返回当前 token 用户名下的设备
  • per_page 最大为 100，超过会自动按 100 处理
  • zt=hidden 会包含掉签和待更新状态；zt=reviewing 会返回仍在审核/预约中的设备

在控制台试一试

填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2已锁定本站
string必填

用户 API Token

number

页码，默认 1

number

每页数量，默认 20，最大 100

string

状态筛选：all=全部，normal=正常，hidden=掉签/封禁，reviewing=审核中，update=待更新

string

售后类型筛选，多个值用英文逗号分隔