返回首頁API 文件
語言: 繁體中文
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
返回文檔列表
GETPOST
v1.0.0stable

獲取設備列表

使用 Token 鑑權查詢當前用戶設備列表，支援分頁和狀態篩選。

GET | POST/api/device/list
驗證:API Key

請求參數

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

參數名類型必填說明
token
string必填
用戶 API Token
範例: your_api_token_here
page
number選填
頁碼，預設 1
範例: 1
per_page
number選填
每頁數量，預設 20，最大 100
範例: 20
zt
string選填
狀態篩選：all=全部，normal=正常，hidden=掉簽/封禁，reviewing=審核中，update=待更新
allnormalhiddenreviewingupdate
範例: all
shtype
string選填
售後類型篩選，多個值用英文逗號分隔
範例: 1,2

回應參數

參數名類型必填說明
code
number必填
狀態碼：1=成功，其他=失敗
範例: 1
msg
string必填
返回訊息
範例: 获取成功
data.devices
array必填
設備列表
data.devices[].kid
string必填
設備 KID
範例: KID001
data.devices[].udid
string必填
設備 UDID
範例: 00008030-001234567890002E
data.devices[].pname
string必填
設備名稱
範例: iPhone 15 Pro
data.devices[].zt
string必填
設備/證書狀態
範例: normal
data.devices[].ytime
number必填
會員到期時間戳，0 表示永久有效
範例: 1772267945
data.devices[].enabled
boolean必填
設備是否啟用
範例: true
data.total
number必填
匹配設備總數
範例: 36
data.page
number必填
當前頁碼
範例: 1
data.per_page
number必填
實際每頁數量，最大 100
範例: 20
data.last_page
number必填
最後一頁頁碼
範例: 2
data.count_normal
number必填
正常設備數量
範例: 30
data.count_hidden
number必填
掉簽/封禁設備數量
範例: 4
data.count_reviewing
number必填
審核中設備數量
範例: 2
回應示例
{
"code":1,
"msg":"獲取成功",
"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"
}

查詢第一頁設備

獲取當前用戶前 20 台設備

查詢第一頁設備
{
"token":"your_api_token_here",
"page":1,
"per_page":20
}

只查詢正常設備

zt=normal 僅返回正常可用設備

只查詢正常設備
{
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
}

查詢審核中設備

zt=reviewing 返回仍在審核/預約中的設備

查詢審核中設備
{
"token":"your_api_token_here",
"zt":"reviewing"
}

每頁最多返回100條

per_page 超過 100 時後端會自動按 100 處理

每頁最多返回100條
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

錯誤碼

錯誤碼2 個定義
12
Token 不能為空
未提供 token 參數
10
Token 無效
token 不存在或用戶狀態不允許訪問

回應語言

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

建議請求標頭
X-Lang: zh-TW
支援的語言
zh, en, zh-TW, vi, ar

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

程式碼示例

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
  -H "X-Lang: zh-TW" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2"

注意事項

  • 列表只返回當前 token 用戶名下的設備
  • per_page 最大為 100，超過會自動按 100 處理
  • zt=hidden 會包含掉簽和待更新狀態；zt=reviewing 會返回仍在審核/預約中的設備

在控制台試一試

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

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2已鎖定本站
string必填

用戶 API Token

number

頁碼，預設 1

number

每頁數量，預設 20，最大 100

string

狀態篩選：all=全部，normal=正常，hidden=掉簽/封禁，reviewing=審核中，update=待更新

string

售後類型篩選，多個值用英文逗號分隔