Back to HomeAPI Docs
Language: English
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
Back to Docs
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

Request Parameters

All parameters can be passed via Query or Body

ParameterTypeRequiredDescription
token
stringRequired
User API token
Example: your_api_token_here
kid
stringOptional
Device KID. Provide either kid or udid. KID is recommended for exact matching
Example: KID001
udid
stringOptional
Device UDID. Provide either kid or udid. Use KID when one UDID has multiple certificates
Example: 00008030-001234567890002E

Response

ParameterTypeRequiredDescription
code
numberRequired
Status code: 1=success, others=failure
Example: 1
msg
stringRequired
Response message
Example: 获取成功
data.kid
stringRequired
Device KID
Example: KID001
data.udid
stringRequired
Device UDID
Example: 00008030-001234567890002E
data.pname
stringRequired
Device name
Example: iPhone 15 Pro
data.type
stringRequired
Device type
Example: iphone
data.zt
stringRequired
Device/certificate status
Example: normal
data.ytime
numberRequired
Membership expiry timestamp. 0 means permanent
Example: 1772267945
data.enabled
booleanRequired
Whether the device is enabled
Example: true
data.beizhu
stringRequired
Device remark
Example: 主力设备
Response Example
{
"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"
}

Error Codes

Error Codes4 defined
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

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

Accept-Language is also supported; X-Lang takes priority. Unsupported languages fall back to English.

Code Examples

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

Notes

  • Provide either kid or udid. Use KID for exact matching when one UDID has multiple certificate records
  • This API can only query devices owned by the current token user
  • Some fields may be empty depending on device status, certificate status, and historical data completeness

Try it in Console

Fill in the parameters below and send a request to test. Requests only go to this site's API; the URL is locked and cannot be changed, and your current login cookie is included.

https://testypro.iwai.cc/api/device/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002ELocked to this site
stringRequired

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