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

Parametry żądania

Wszystkie parametry mogą być przekazywane za pośrednictwem zapytania lub ciała

ParametrRodzajWymaganeOpis
token
stringWymagane
User API token
Przykład: your_api_token_here
kid
stringOpcjonalnie
Device KID. Provide either kid or udid. KID is recommended for exact matching
Przykład: KID001
udid
stringOpcjonalnie
Device UDID. Provide either kid or udid. Use KID when one UDID has multiple certificates
Przykład: 00008030-001234567890002E

Odpowiedź

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

Kod błędu

Kod błędu4 zdefiniowane
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

Język odpowiedzi

Dostosuj język odpowiedzi API do nagłówka X- Lang. Poniższe przykłady kodów automatycznie korzystają z aktualnego języka strony.

Zalecany nagłówek
X-Lang: pl
Obsługiwane języki
zh, en, zh-TW, vi, ar, es, ru

Obsługiwane jest również Accept- Language; X- Lang ma pierwszeństwo. Nieobsługiwane języki podążają za zapasami języka strony.

Przykłady kodów

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

Uwagi

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

Spróbuj w konsoli

Wypełnij poniższe parametry i wyślij wniosek o przetestowanie. Żądania są kierowane tylko do API tej witryny; adres URL jest zablokowany i nie może być zmieniony, a obecne pliki cookie logowania są włączone.

https://testypro.iwai.cc/api/device/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002EZamknięte na tej stronie
stringWymagane

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