GETPOST

v1.0.0stable

Thông tin thiết bị

Truy vấn thông tin chi tiết thiết bị bằng KID hoặc UDID với xác thực token.

GET | POST/api/device/info

Xác thực:API Key

Tham 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
`kid`	string	Tùy chọn	KID thiết bị. Cung cấp kid hoặc udid Ví dụ: KID001
`udid`	string	Tùy chọn	UDID thiết bị. Dùng KID khi một UDID có nhiều chứng chỉ Ví dụ: 00008030-001234567890002E

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.kid`	string	Bắt buộc	KID thiết bị Ví dụ: KID001
`data.udid`	string	Bắt buộc	UDID thiết bị Ví dụ: 00008030-001234567890002E
`data.pname`	string	Bắt buộc	Tên thiết bị Ví dụ: iPhone 15 Pro
`data.type`	string	Bắt buộc	Loại thiết bị Ví dụ: iphone
`data.zt`	string	Bắt buộc	Trạng thái thiết bị/chứng chỉ Ví dụ: normal
`data.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.enabled`	boolean	Bắt buộc	Thiết bị có đang bật không Ví dụ: true
`data.beizhu`	string	Bắt buộc	Ghi chú thiết bị Ví dụ: 主力设备

Ví dụ phản hồi

{

"code":1,

"msg":"Thành công",

"time":1769675945,

"data":

{

"kid":"KID001",

"udid":"00008030-001234567890002E",

"pname":"iPhone 15 Pro",

"type":"iphone",

"shtype":1,

"zt":"normal",

"ytime":1772267945,

"enabled":true,

"beizhu":"主力设备"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Mã lỗi

Mã lỗi4 được định nghĩa

12

Token không được để trống

Thiếu tham số token

20

Vui lòng cung cấp kid hoặc udid

Thiếu định danh thiết bị

100

Không tìm thấy thiết bị hoặc không có quyền

Thiết bị không tồn tại hoặc không thuộc token này

Ngô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.

Header đề xuất

X-Lang: vi

Ngôn ngữ được hỗ trợ

zh, en, zh-TW, vi, ar

Bạ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 GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002E" \
  -H "X-Lang: vi"

Lưu ý

Cung cấp kid hoặc udid. Dùng KID để khớp chính xác khi một UDID có nhiều chứng chỉ
API này chỉ truy vấn thiết bị thuộc người dùng token hiện tại
Một số trường có thể rỗng tùy trạng thái thiết bị, chứng chỉ và dữ liệu lịch sử

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/info?token=your_api_token_here&kid=KID001&udid=00008030-001234567890002EĐã khóa vào trang này

tokenstringBắt buộc

API Token người dùng

kidstring

KID thiết bị. Cung cấp kid hoặc udid

udidstring

UDID thiết bị. Dùng KID khi một UDID có nhiều chứng chỉ