GETPOST

v1.0.0stable

Consulter la Liste des Appareils

Interroger la liste des appareils de l'utilisateur authentifié avec pagination et filtres d'état.

GET | POST/api/device/list

Authentification:API Key

Paramètres de la requête

Tous les paramètres peuvent être transmis via Query ou Body

Paramètre	Type	Requis	Description
`token`	string	Requis	Jeton API utilisateur Exemple: your_api_token_here
`page`	number	Optionnel	Numéro de page. Par défaut 1 Exemple: 1
`per_page`	number	Optionnel	Articles par page. Par défaut 20, maximum 100 Exemple: 20
`zt`	string	Optionnel	Filtre de statut : tous, normal, caché, en révision, ou mise à jour allnormalhiddenreviewingupdate Exemple: all
`shtype`	string	Optionnel	Filtre de type après-vente. Séparez plusieurs valeurs par des virgules Exemple: 1,2

Réponse

Paramètre	Type	Requis	Description
`code`	number	Requis	Code d'état : 1=succès, autres=échec Exemple: 1
`msg`	string	Requis	Message de réponse Exemple: 获取成功
`data.devices`	array	Requis	Liste des appareils
`data.devices[].kid`	string	Requis	KID de l'appareil Exemple: KID001
`data.devices[].udid`	string	Requis	UDID de l'appareil Exemple: 00008030-001234567890002E
`data.devices[].pname`	string	Requis	Nom de l'appareil Exemple: iPhone 15 Pro
`data.devices[].zt`	string	Requis	Statut appareil/certificat Exemple: normal
`data.devices[].ytime`	number	Requis	Timestamp d'expiration de l'adhésion. 0 signifie permanent Exemple: 1772267945
`data.devices[].enabled`	boolean	Requis	Si l'appareil est activé Exemple: true
`data.total`	number	Requis	Nombre total d'appareils correspondants Exemple: 36
`data.page`	number	Requis	Numéro de la page actuelle Exemple: 1
`data.per_page`	number	Requis	Nombre réel d'éléments par page, maximum 100 Exemple: 20
`data.last_page`	number	Requis	Numéro de la dernière page Exemple: 2
`data.count_normal`	number	Requis	Nombre d'appareils normaux Exemple: 30
`data.count_hidden`	number	Requis	Nombre d'appareils supprimés/bannis Exemple: 4
`data.count_reviewing`	number	Requis	Nombre d'appareils en révision Exemple: 2

Exemple de réponse

{

"code":1,

"msg":"Succès",

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

}

Interroger la première page

Obtenir les 20 premiers appareils de l'utilisateur actuel

Interroger la première page

{

"token":"your_api_token_here",

"page":1,

"per_page":20

}

Seulement des appareils normaux

Utilisez zt=normal pour ne retourner que les appareils normaux disponibles

Seulement des appareils normaux

{

"token":"your_api_token_here",

"zt":"normal",

"page":1,

"per_page":50

}

Appareils en cours de vérification

Utilisez zt=reviewing pour retourner les appareils encore en cours de vérification/réservation

Appareils en cours de vérification

{

"token":"your_api_token_here",

"zt":"reviewing"

}

Maximum 100 éléments par page

Si per_page est supérieur à 100, le backend le limite automatiquement à 100

Maximum 100 éléments par page

{

"token":"your_api_token_here",

"page":1,

"per_page":100

}

Codes d'erreur

Codes d'erreur2 défini

12

Le jeton est requis

Paramètre de jeton manquant

10

Jeton invalide

Le jeton n'existe pas ou le statut de l'utilisateur n'est pas autorisé

Response Language

Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.

Recommended Header

X-Lang: en

Supported Languages

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

Accept-Language is also supported; X-Lang takes priority. Unsupported languages follow the site language fallback.

Exemples de code

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"

Remarques

La liste retourne uniquement les appareils appartenant à l'utilisateur actuel du jeton
Le maximum par_page est de 100. Les valeurs plus grandes sont automatiquement limitées à 100
zt=hidden inclut les états dropped et update-needed. zt=reviewing renvoie les appareils encore en cours de révision/réservation

Essayez-le dans la Console

Remplissez les paramètres ci-dessous et envoyez une requête pour tester. Les requêtes ne vont qu'à l'API de ce site ; l'URL est verrouillée et ne peut pas être modifiée, et votre cookie de connexion actuel est inclus.

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Verrouillé sur ce site

tokenstringRequis

Jeton API utilisateur

pagenumber

Numéro de page. Par défaut 1

per_pagenumber

Articles par page. Par défaut 20, maximum 100

ztstring

Filtre de statut : tous, normal, caché, en révision, ou mise à jour

shtypestring

Filtre de type après-vente. Séparez plusieurs valeurs par des virgules