GETPOST

v1.0.0stable

Get Device List

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

GET | POST/api/device/list

Auth:API Key

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

Parametro	Tipo	Obbligo	Descrizione
`token`	string	Obbligo	User API token Esempio: your_api_token_here
`page`	number	Facoltativo	Page number. Default 1 Esempio: 1
`per_page`	number	Facoltativo	Items per page. Default 20, maximum 100 Esempio: 20
`zt`	string	Facoltativo	Status filter: all, normal, hidden, reviewing, or update allnormalhiddenreviewingupdate Esempio: all
`shtype`	string	Facoltativo	After-sales type filter. Separate multiple values with commas Esempio: 1,2

Risposta

Parametro	Tipo	Obbligo	Descrizione
`code`	number	Obbligo	Status code: 1=success, others=failure Esempio: 1
`msg`	string	Obbligo	Response message Esempio: 获取成功
`data.devices`	array	Obbligo	Device list
`data.devices[].kid`	string	Obbligo	Device KID Esempio: KID001
`data.devices[].udid`	string	Obbligo	Device UDID Esempio: 00008030-001234567890002E
`data.devices[].pname`	string	Obbligo	Device name Esempio: iPhone 15 Pro
`data.devices[].zt`	string	Obbligo	Device/certificate status Esempio: normal
`data.devices[].ytime`	number	Obbligo	Membership expiry timestamp. 0 means permanent Esempio: 1772267945
`data.devices[].enabled`	boolean	Obbligo	Whether the device is enabled Esempio: true
`data.total`	number	Obbligo	Total matched devices Esempio: 36
`data.page`	number	Obbligo	Current page number Esempio: 1
`data.per_page`	number	Obbligo	Actual items per page, maximum 100 Esempio: 20
`data.last_page`	number	Obbligo	Last page number Esempio: 2
`data.count_normal`	number	Obbligo	Normal device count Esempio: 30
`data.count_hidden`	number	Obbligo	Dropped/banned device count Esempio: 4
`data.count_reviewing`	number	Obbligo	Reviewing device count Esempio: 2

Esempio di risposta

{

"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

}

Codici di errore

Codici di errore2 definito

12

Token is required

Missing token parameter

10

Invalid token

Token does not exist or user status is not allowed

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata

X-Lang: it

Lingue supportate

zh, en, zh-TW, vi, ar, es, ru

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

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

Note

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

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Bloccato a questo sito

tokenstringObbligo

User API token

pagenumber

Page number. Default 1

per_pagenumber

Items per page. Default 20, maximum 100

ztstring

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

shtypestring

After-sales type filter. Separate multiple values with commas