GETPOST
v1.0.0stable

Get Device Info

Query detailed device information by KID or UDID using token authentication.

GET | POST/api/device/info
Auth:API Key

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

ParametroTipoObbligoDescrizione
token
stringObbligo
User API token
Esempio: your_api_token_here
kid
stringFacoltativo
Device KID. Provide either kid or udid. KID is recommended for exact matching
Esempio: KID001
udid
stringFacoltativo
Device UDID. Provide either kid or udid. Use KID when one UDID has multiple certificates
Esempio: 00008030-001234567890002E

Risposta

ParametroTipoObbligoDescrizione
code
numberObbligo
Status code: 1=success, others=failure
Esempio: 1
msg
stringObbligo
Response message
Esempio: 获取成功
data.kid
stringObbligo
Device KID
Esempio: KID001
data.udid
stringObbligo
Device UDID
Esempio: 00008030-001234567890002E
data.pname
stringObbligo
Device name
Esempio: iPhone 15 Pro
data.type
stringObbligo
Device type
Esempio: iphone
data.zt
stringObbligo
Device/certificate status
Esempio: normal
data.ytime
numberObbligo
Membership expiry timestamp. 0 means permanent
Esempio: 1772267945
data.enabled
booleanObbligo
Whether the device is enabled
Esempio: true
data.beizhu
stringObbligo
Device remark
Esempio: 主力设备
Esempio di risposta
{
"code":1,
"msg":"Success",
"time":1769675945,
"data":
{
"kid":"KID001",
"udid":"00008030-001234567890002E",
"pname":"iPhone 15 Pro",
"type":"iphone",
"shtype":1,
"zt":"normal",
"ytime":1772267945,
"enabled":true,
"beizhu":"主力设备"
}
,
"ip":"192.168.1.100",
"ysucc":"Ysucc"
}

Codici di errore

Codici di errore4 definito
12
Token is required
Missing token parameter
20
Please provide kid or udid
Missing device identifier
100
Device not found or no permission
Device does not exist or is not owned by token user

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 GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002E" \
  -H "X-Lang: it"

Note

  • kid 和 udid 二选一;同一 UDID 存在多条证书记录时建议使用 KID 精确查询
  • 该接口只能查询当前 token 用户名下的设备
  • 返回字段可能随设备状态、证书状态和历史数据完整度不同而为空

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/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002EBloccato a questo sito
stringObbligo

User API token

string

Device KID. Provide either kid or udid. KID is recommended for exact matching

string

Device UDID. Provide either kid or udid. Use KID when one UDID has multiple certificates