GETPOST

v1.0.0stable

獲取設備資訊

使用 Token 鑑權，通過 KID 或 UDID 查詢設備詳細資訊。

GET | POST/api/device/info

驗證:API Key

請求參數

所有請求參數需透過 Query 或 Body 傳遞

參數名	類型	必填	說明
`token`	string	必填	用戶 API Token 範例: your_api_token_here
`kid`	string	選填	設備 KID，與 udid 二選一；建議優先使用 KID 精確查詢範例: KID001
`udid`	string	選填	設備 UDID，與 kid 二選一；同一 UDID 多證書時請改用 KID 範例: 00008030-001234567890002E

回應參數

參數名	類型	必填	說明
`code`	number	必填	狀態碼：1=成功，其他=失敗範例: 1
`msg`	string	必填	返回訊息範例: 获取成功
`data.kid`	string	必填	設備 KID 範例: KID001
`data.udid`	string	必填	設備 UDID 範例: 00008030-001234567890002E
`data.pname`	string	必填	設備名稱範例: iPhone 15 Pro
`data.type`	string	必填	設備類型範例: iphone
`data.zt`	string	必填	設備/證書狀態範例: normal
`data.ytime`	number	必填	會員到期時間戳，0 表示永久有效範例: 1772267945
`data.enabled`	boolean	必填	設備是否啟用範例: true
`data.beizhu`	string	必填	設備備註範例: 主力设备

回應示例

{

"code":1,

"msg":"獲取成功",

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

}

錯誤碼

錯誤碼4 個定義

12

Token 不能為空

未提供 token 參數

20

請提供 kid 或 udid

未提供設備標識

100

設備不存在或無權限操作

設備不存在或不屬於當前 token 用戶

回應語言

透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。

建議請求標頭

X-Lang: zh-TW

支援的語言

zh, en, zh-TW, vi, ar

也可以使用 Accept-Language；X-Lang 優先級更高。不支援的語言將回退為英文。

程式碼示例

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: zh-TW"

注意事項

kid 和 udid 二選一；同一 UDID 存在多條證書記錄時建議使用 KID 精確查詢
該接口只能查詢當前 token 用戶名下的設備
返回欄位可能隨設備狀態、證書狀態和歷史資料完整度不同而為空

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

https://testypro.iwai.cc/api/device/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002E已鎖定本站

tokenstring必填

用戶 API Token

kidstring

設備 KID，與 udid 二選一；建議優先使用 KID 精確查詢

udidstring

設備 UDID，與 kid 二選一；同一 UDID 多證書時請改用 KID