GETPOST
v1.0.0stableดูรายการอุปกรณ์
ค้นหารายการอุปกรณ์ของผู้ใช้ที่ผ่านการรับรองพร้อมการแบ่งหน้าและตัวกรองสถานะ
GET | POST
/api/device/listการยืนยันตัวตน:API Key
พารามิเตอร์คำขอ
พารามิเตอร์ทั้งหมดสามารถส่งผ่าน Query หรือ Body
| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
token | string | จำเป็น | โทเค็น API ของผู้ใช้ ตัวอย่าง: your_api_token_here |
page | number | ตัวเลือก | หมายเลขหน้า ค่าเริ่มต้น 1 ตัวอย่าง: 1 |
per_page | number | ตัวเลือก | จำนวนรายการต่อหน้า ค่าเริ่มต้น 20 สูงสุด 100 ตัวอย่าง: 20 |
zt | string | ตัวเลือก | ตัวกรองสถานะ: ทั้งหมด, ปกติ, ซ่อน, กำลังตรวจสอบ, หรืออัปเดต 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 ระบบ backend จะจำกัดโดยอัตโนมัติที่ 100
สูงสุด 100 รายการต่อหน้า
{}
"token":"your_api_token_here",
"page":1,
"per_page":100
รหัสข้อผิดพลาด
รหัสข้อผิดพลาด2 กำหนดไว้
12ต้องใช้โทเค็น
ขาดพารามิเตอร์ token
10โทเค็นไม่ถูกต้อง
โทเค็นไม่มีอยู่หรือสถานะผู้ใช้ไม่อนุญาต
X-Lang: enzh, en, zh-TW, vi, arตัวอย่างโค้ด
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
-H "X-Lang: en" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2"หมายเหตุ
- รายการจะส่งกลับเฉพาะอุปกรณ์ที่ผู้ใช้โทเค็นปัจจุบันเป็นเจ้าของ
- จำนวนสูงสุดต่อหน้า (per_page) คือ 100 ค่าที่มากกว่าจะถูกจำกัดอัตโนมัติที่ 100
- zt=hidden รวมถึงสถานะ dropped และ update-needed. 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จำเป็น
โทเค็น API ของผู้ใช้
number
หมายเลขหน้า ค่าเริ่มต้น 1
number
จำนวนรายการต่อหน้า ค่าเริ่มต้น 20 สูงสุด 100
string
ตัวกรองสถานะ: ทั้งหมด, ปกติ, ซ่อน, กำลังตรวจสอบ, หรืออัปเดต
string
ตัวกรองประเภทหลังการขาย แยกค่าหลายค่าโดยใช้เครื่องหมายจุลภาค