Danh sách thiết bị
Truy vấn danh sách thiết bị của người dùng với phân trang và bộ lọc trạng thái.
/api/device/listTham số yêu cầu
Tất cả tham số có thể truyền qua Query hoặc Body
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
token | string | Bắt buộc | API Token người dùng Ví dụ: your_api_token_here |
page | number | Tùy chọn | Số trang, mặc định 1 Ví dụ: 1 |
per_page | number | Tùy chọn | Số lượng mỗi trang, mặc định 20, tối đa 100 Ví dụ: 20 |
zt | string | Tùy chọn | Lọc trạng thái: all, normal, hidden, reviewing hoặc update allnormalhiddenreviewingupdate Ví dụ: all |
shtype | string | Tùy chọn | Lọc loại hậu mãi, nhiều giá trị phân tách bằng dấu phẩy Ví dụ: 1,2 |
Phản hồi
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
code | number | Bắt buộc | Mã trạng thái: 1=thành công Ví dụ: 1 |
msg | string | Bắt buộc | Tin nhắn phản hồi Ví dụ: 获取成功 |
data.devices | array | Bắt buộc | Danh sách thiết bị |
data.devices[].kid | string | Bắt buộc | KID thiết bị Ví dụ: KID001 |
data.devices[].udid | string | Bắt buộc | UDID thiết bị Ví dụ: 00008030-001234567890002E |
data.devices[].pname | string | Bắt buộc | Tên thiết bị Ví dụ: iPhone 15 Pro |
data.devices[].zt | string | Bắt buộc | Trạng thái thiết bị/chứng chỉ Ví dụ: normal |
data.devices[].ytime | number | Bắt buộc | Timestamp hết hạn thành viên, 0 là vĩnh viễn Ví dụ: 1772267945 |
data.devices[].enabled | boolean | Bắt buộc | Thiết bị có đang bật không Ví dụ: true |
data.total | number | Bắt buộc | Tổng số thiết bị khớp Ví dụ: 36 |
data.page | number | Bắt buộc | Trang hiện tại Ví dụ: 1 |
data.per_page | number | Bắt buộc | Số lượng thực tế mỗi trang, tối đa 100 Ví dụ: 20 |
data.last_page | number | Bắt buộc | Trang cuối Ví dụ: 2 |
data.count_normal | number | Bắt buộc | Số thiết bị bình thường Ví dụ: 30 |
data.count_hidden | number | Bắt buộc | Số thiết bị rớt chứng chỉ/bị chặn Ví dụ: 4 |
data.count_reviewing | number | Bắt buộc | Số thiết bị đang xét duyệt Ví dụ: 2 |
Truy vấn trang đầu
Lấy 20 thiết bị đầu tiên của người dùng hiện tại
Chỉ thiết bị bình thường
Dùng zt=normal để chỉ trả về thiết bị bình thường
Thiết bị đang xét duyệt
Dùng zt=reviewing để trả về thiết bị đang xét duyệt/đặt trước
Tối đa 100 mục mỗi trang
Nếu per_page lớn hơn 100, backend sẽ tự động giới hạn về 100
Mã lỗi
1210Ngôn ngữ phản hồi
Tùy chỉnh ngôn ngữ phản hồi API bằng header X-Lang. Ví dụ mã bên dưới tự động sử dụng ngôn ngữ trang hiện tại của bạn.
X-Lang: vizh, en, zh-TW, vi, arBạn cũng có thể dùng Accept-Language; X-Lang có ưu tiên cao hơn. Ngôn ngữ không được hỗ trợ sẽ chuyển sang tiếng Anh.
Ví dụ mã
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
-H "X-Lang: vi" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2"Lưu ý
- Danh sách chỉ trả về thiết bị thuộc người dùng token hiện tại
- per_page tối đa là 100, giá trị lớn hơn sẽ tự động giới hạn về 100
- zt=hidden bao gồm trạng thái rớt chứng chỉ và cần cập nhật; zt=reviewing trả về thiết bị đang xét duyệt/đặt trước
Thử trong Console
Điền các tham số bên dưới rồi gửi yêu cầu để kiểm tra. Yêu cầu chỉ gửi đến API của trang này; địa chỉ đã bị khóa và không thể thay đổi, đồng thời kèm theo Cookie đăng nhập hiện tại của bạn.
https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2Đã khóa vào trang nàyAPI Token người dùng
Số trang, mặc định 1
Số lượng mỗi trang, mặc định 20, tối đa 100
Lọc trạng thái: all, normal, hidden, reviewing hoặc update
Lọc loại hậu mãi, nhiều giá trị phân tách bằng dấu phẩy