GETPOST
v1.0.0stable

Get Device List

Query the authenticated user device list with pagination and status filters.

GET | POST/api/device/list
অনুমোদন:API Key

অনুরোধ করা পরামিতি

সকল পরামিতি অনুসন্ধান বা মৃতদেহের মাধ্যমে অতিক্রম করা যাবে

পরামিতিধরনআবশ্যকবিবরণ
token
stringআবশ্যক
User API token
উদাহরণ: your_api_token_here
page
numberবিকল্প
Page number. Default 1
উদাহরণ: 1
per_page
numberবিকল্প
Items per page. Default 20, maximum 100
উদাহরণ: 20
zt
stringবিকল্প
Status filter: all, normal, hidden, reviewing, or update
allnormalhiddenreviewingupdate
উদাহরণ: all
shtype
stringবিকল্প
After-sales type filter. Separate multiple values with commas
উদাহরণ: 1,2

প্রতিক্রিয়া

পরামিতিধরনআবশ্যকবিবরণ
code
numberআবশ্যক
Status code: 1=success, others=failure
উদাহরণ: 1
msg
stringআবশ্যক
Response message
উদাহরণ: 获取成功
data.devices
arrayআবশ্যক
Device list
data.devices[].kid
stringআবশ্যক
Device KID
উদাহরণ: KID001
data.devices[].udid
stringআবশ্যক
Device UDID
উদাহরণ: 00008030-001234567890002E
data.devices[].pname
stringআবশ্যক
Device name
উদাহরণ: iPhone 15 Pro
data.devices[].zt
stringআবশ্যক
Device/certificate status
উদাহরণ: normal
data.devices[].ytime
numberআবশ্যক
Membership expiry timestamp. 0 means permanent
উদাহরণ: 1772267945
data.devices[].enabled
booleanআবশ্যক
Whether the device is enabled
উদাহরণ: true
data.total
numberআবশ্যক
Total matched devices
উদাহরণ: 36
data.page
numberআবশ্যক
Current page number
উদাহরণ: 1
data.per_page
numberআবশ্যক
Actual items per page, maximum 100
উদাহরণ: 20
data.last_page
numberআবশ্যক
Last page number
উদাহরণ: 2
data.count_normal
numberআবশ্যক
Normal device count
উদাহরণ: 30
data.count_hidden
numberআবশ্যক
Dropped/banned device count
উদাহরণ: 4
data.count_reviewing
numberআবশ্যক
Reviewing device count
উদাহরণ: 2
রেসপন্স উদাহরণ
{
"code":1,
"msg":"Success",
"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"
}

Query first page

Get the first 20 devices of the current user

Query first page
{
"token":"your_api_token_here",
"page":1,
"per_page":20
}

Only normal devices

Use zt=normal to return only normal available devices

Only normal devices
{
"token":"your_api_token_here",
"zt":"normal",
"page":1,
"per_page":50
}

Reviewing devices

Use zt=reviewing to return devices still in review/reservation

Reviewing devices
{
"token":"your_api_token_here",
"zt":"reviewing"
}

Maximum 100 items per page

If per_page is greater than 100, the backend automatically caps it at 100

Maximum 100 items per page
{
"token":"your_api_token_here",
"page":1,
"per_page":100
}

ত্রুটিপূর্ণ কোড

ত্রুটিপূর্ণ কোড2 নির্ধারিত
12
Token is required
Missing token parameter
10
Invalid token
Token does not exist or user status is not allowed

বহিরাগত ভাষা

X-Lang হেডারের সাথে API প্রতিক্রিয়া গ্রহণ করুন। টি কোড স্বয়ংক্রিয়ভাবে আপনার বর্তমান অবস্থানের জন্য ব্যবহার করা হচ্ছে।

প্রস্তাবিত হেডার
X-Lang: bn
সমর্থিত ভাষা
zh, en, zh-TW, vi, ar, es, ru

সমর্থিত ভাষাও সমর্থিত নয়; X-Lang এর অগ্রাধিকার গ্রহণ করা হয়। ওয়েব-সাইট ফাইলটির সাহায্যে সমর্থিত হয়।

কোড উদাহরণ

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
  -H "X-Lang: bn" \
  -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- এ কেবল অনুরোধ করা হয়; URL- টি লক করা হয়েছে এবং আপনার বর্তমান লগ- ইন কুকি অন্তর্ভুক্ত করা যাবে না।

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2এই সাইটের লক করা হয়েছে
stringআবশ্যক

User API token

number

Page number. Default 1

number

Items per page. Default 20, maximum 100

string

Status filter: all, normal, hidden, reviewing, or update

string

After-sales type filter. Separate multiple values with commas