GETPOST
v1.0.0stable

Get Device List

Query the authenticated user device list with pagination and status filters.

GET | POST/api/device/list
Ang Auth:API Key

Kahilingan ng mga Parameter

Ang lahat ng parameter ay maaaring ipasa sa pamamagitan ng Query o Body

ParameterUriKailanganPaglalarawan
token
stringKailangan
User API token
Halimbawa: your_api_token_here
page
numberMapagpipilian
Page number. Default 1
Halimbawa: 1
per_page
numberMapagpipilian
Items per page. Default 20, maximum 100
Halimbawa: 20
zt
stringMapagpipilian
Status filter: all, normal, hidden, reviewing, or update
allnormalhiddenreviewingupdate
Halimbawa: all
shtype
stringMapagpipilian
After-sales type filter. Separate multiple values with commas
Halimbawa: 1,2

Pagtugon

ParameterUriKailanganPaglalarawan
code
numberKailangan
Status code: 1=success, others=failure
Halimbawa: 1
msg
stringKailangan
Response message
Halimbawa: 获取成功
data.devices
arrayKailangan
Device list
data.devices[].kid
stringKailangan
Device KID
Halimbawa: KID001
data.devices[].udid
stringKailangan
Device UDID
Halimbawa: 00008030-001234567890002E
data.devices[].pname
stringKailangan
Device name
Halimbawa: iPhone 15 Pro
data.devices[].zt
stringKailangan
Device/certificate status
Halimbawa: normal
data.devices[].ytime
numberKailangan
Membership expiry timestamp. 0 means permanent
Halimbawa: 1772267945
data.devices[].enabled
booleanKailangan
Whether the device is enabled
Halimbawa: true
data.total
numberKailangan
Total matched devices
Halimbawa: 36
data.page
numberKailangan
Current page number
Halimbawa: 1
data.per_page
numberKailangan
Actual items per page, maximum 100
Halimbawa: 20
data.last_page
numberKailangan
Last page number
Halimbawa: 2
data.count_normal
numberKailangan
Normal device count
Halimbawa: 30
data.count_hidden
numberKailangan
Dropped/banned device count
Halimbawa: 4
data.count_reviewing
numberKailangan
Reviewing device count
Halimbawa: 2
Pagtugon na Halimbawa
{
"code":1,
"msg":"Success",
"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"
}

Query first page

Get the first 20 devices of the current user

Query first page
{
"token":"your_api_token_here",
"page":1,
"per_page":20
}

Only normal devices

Use zt=normal to return only normal available devices

Only normal devices
{
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
}

Reviewing devices

Use zt=reviewing to return devices still in review/reservation

Reviewing devices
{
"token":"your_api_token_here",
"zt":"reviewing"
}

Maximum 100 items per page

If per_page is greater than 100, the backend automatically caps it at 100

Maximum 100 items per page
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

Error

Error2 Binigyang - katuturan
12
Token is required
Missing token parameter
10
Invalid token
Token does not exist or user status is not allowed

Pagtugon sa Wika

Ang mga code na halimbawa sa ibaba ay awtomatikong gumagamit ng kasalukuyang site language mo.

Inirerekomendang Tagapangulo
X-Lang: fil
Suportadong mga Wika
zh, en, zh-TW, vi, ar, es, ru

Sinusuportahan din ang tinatanggap na-Language; ang X-Lang ang inuuna. ang mga hindi suportadong wika ay sumusunod sa site language fallback.

Mga Halimbawa ng Kodigo

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

Mga Noble

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

Subukin ito sa Console

Punan ang mga parameter sa ibaba at magpadala ng kahilingan upang masubukan. requests pumunta lamang sa API ng site na ito; ang URL ay naka-lock at hindi maaaring baguhin, at isama ang inyong kasalukuyang login cookie.

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Nakakandado sa lugar na ito
stringKailangan

User API token

number

Page number. Default 1

number

Items per page. Default 20, maximum 100

string

Status filter: all, normal, hidden, reviewing, or update

string

After-sales type filter. Separate multiple values with commas