GETPOST

v1.0.0stable

Consultar Lista de Dispositivos

Consultar la lista de dispositivos del usuario autenticado con paginación y filtros de estado.

GET | POST/api/device/list

Autenticación:API Key

Parámetros de solicitud

Todos los parámetros se pueden pasar vía Consulta o Cuerpo

Parámetro	Tipo	Requerido	Descripción
`token`	string	Requerido	Token de API de usuario Ejemplo: your_api_token_here
`page`	number	Opcional	Número de página. Predeterminado 1 Ejemplo: 1
`per_page`	number	Opcional	Elementos por página. Predeterminado 20, máximo 100 Ejemplo: 20
`zt`	string	Opcional	Filtro de estado: todos, normales, ocultos, en revisión o actualización allnormalhiddenreviewingupdate Ejemplo: all
`shtype`	string	Opcional	Filtro por tipo de postventa. Separe múltiples valores con comas Ejemplo: 1,2

Respuesta

Parámetro	Tipo	Requerido	Descripción
`code`	number	Requerido	Código de estado: 1=éxito, otros=fallo Ejemplo: 1
`msg`	string	Requerido	Mensaje de respuesta Ejemplo: 获取成功
`data.devices`	array	Requerido	Lista de dispositivos
`data.devices[].kid`	string	Requerido	KID del dispositivo Ejemplo: KID001
`data.devices[].udid`	string	Requerido	UDID del dispositivo Ejemplo: 00008030-001234567890002E
`data.devices[].pname`	string	Requerido	Nombre del dispositivo Ejemplo: iPhone 15 Pro
`data.devices[].zt`	string	Requerido	Estado del dispositivo/certificado Ejemplo: normal
`data.devices[].ytime`	number	Requerido	Marca temporal de expiración de membresía. 0 significa permanente Ejemplo: 1772267945
`data.devices[].enabled`	boolean	Requerido	Si el dispositivo está habilitado Ejemplo: true
`data.total`	number	Requerido	Total de dispositivos coincidentes Ejemplo: 36
`data.page`	number	Requerido	Número de página actual Ejemplo: 1
`data.per_page`	number	Requerido	Artículos reales por página, máximo 100 Ejemplo: 20
`data.last_page`	number	Requerido	Número de la última página Ejemplo: 2
`data.count_normal`	number	Requerido	Cantidad de dispositivos normales Ejemplo: 30
`data.count_hidden`	number	Requerido	Cantidad de dispositivos eliminados/prohibidos Ejemplo: 4
`data.count_reviewing`	number	Requerido	Cantidad de dispositivos en revisión Ejemplo: 2

Ejemplo de respuesta

{

"code":1,

"msg":"Éxito",

"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"

}

Consultar primera página

Obtener los primeros 20 dispositivos del usuario actual

Consultar primera página

{

"token":"your_api_token_here",

"page":1,

"per_page":20

}

Solo dispositivos normales

Use zt=normal para devolver solo los dispositivos normales disponibles

Solo dispositivos normales

{

"token":"your_api_token_here",

"zt":"normal",

"page":1,

"per_page":50

}

Revisando dispositivos

Use zt=reviewing para devolver dispositivos que aún están en revisión/reserva

Revisando dispositivos

{

"token":"your_api_token_here",

"zt":"reviewing"

}

Máximo 100 elementos por página

Si per_page es mayor a 100, el backend lo limita automáticamente a 100

Máximo 100 elementos por página

{

"token":"your_api_token_here",

"page":1,

"per_page":100

}

Códigos de error

Códigos de error2 definido

12

Se requiere token

Parámetro de token faltante

10

Token inválido

El token no existe o el estado del usuario no está permitido

X-Lang: en

zh, en, zh-TW, vi, ar

Ejemplos de código

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

Notas

La lista solo devuelve dispositivos propiedad del usuario del token actual
El máximo por página es 100. Los valores mayores se limitan automáticamente a 100
zt=hidden incluye los estados dropped y update-needed. zt=reviewing devuelve dispositivos que aún están en revisión/reserva

Pruébalo en la Consola

Complete los parámetros a continuación y envíe una solicitud para probar. Las solicitudes solo van a la API de este sitio; la URL está bloqueada y no se puede cambiar, y se incluye su cookie de inicio de sesión actual.

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

tokenstringRequerido

Token de API de usuario

pagenumber

Número de página. Predeterminado 1

per_pagenumber

Elementos por página. Predeterminado 20, máximo 100

ztstring

Filtro de estado: todos, normales, ocultos, en revisión o actualización

shtypestring

Filtro por tipo de postventa. Separe múltiples valores con comas