ดูรายการอุปกรณ์
ค้นหารายการอุปกรณ์ของผู้ใช้ที่ผ่านการรับรองพร้อมการแบ่งหน้าและตัวกรองสถานะ
/api/device/listพารามิเตอร์คำขอ
พารามิเตอร์ทั้งหมดสามารถส่งผ่าน 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 |
ดึงหน้าหลักของการค้นหา
รับอุปกรณ์ 20 ชิ้นแรกของผู้ใช้ปัจจุบัน
อุปกรณ์ปกติเท่านั้น
ใช้ zt=normal เพื่อส่งกลับเฉพาะอุปกรณ์ปกติที่มีอยู่
กำลังตรวจสอบอุปกรณ์
ใช้ zt=reviewing เพื่อส่งกลับอุปกรณ์ที่ยังอยู่ระหว่างการตรวจสอบ/สำรอง
สูงสุด 100 รายการต่อหน้า
หาก per_page มากกว่า 100 ระบบ backend จะจำกัดโดยอัตโนมัติที่ 100
รหัสข้อผิดพลาด
1210Response Language
Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.
X-Lang: enzh, en, zh-TW, vi, ar, es, ruAccept-Language is also supported; X-Lang takes priority. Unsupported languages follow the site language fallback.
ตัวอย่างโค้ด
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ถูกล็อกกับเว็บไซต์นี้โทเค็น API ของผู้ใช้
หมายเลขหน้า ค่าเริ่มต้น 1
จำนวนรายการต่อหน้า ค่าเริ่มต้น 20 สูงสุด 100
ตัวกรองสถานะ: ทั้งหมด, ปกติ, ซ่อน, กำลังตรวจสอบ, หรืออัปเดต
ตัวกรองประเภทหลังการขาย แยกค่าหลายค่าโดยใช้เครื่องหมายจุลภาค