GETPOST
v1.0.0stableĐặt trạng thái thiết bị
Cập nhật trạng thái thiết bị bằng xác thực token
GET | POST
/api/device/statusXác thực:API Key
Giới hạn:60/phút
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 | Token API 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ụ: ABC123XYZ |
udid | string | Tùy chọn | UDID thiết bị. Cung cấp kid hoặc udid Ví dụ: 00008030-001234567890002E |
action | string | Tùy chọn | Hành động: enable, disable hoặc toggle. Mặc định là toggle enabledisabletoggle Ví dụ: disable |
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, khác=thất bại Ví dụ: 1 |
msg | string | Bắt buộc | Tin nhắn phản hồi Ví dụ: 设备已禁用 |
time | number | Bắt buộc | Mốc thời gian máy chủ (giây Unix) Ví dụ: 1769675945 |
data | object | Bắt buộc | Dữ liệu phản hồi |
data.id | number | Bắt buộc | ID thiết bị Ví dụ: 12345 |
data.kid | string | Bắt buộc | KID thiết bị Ví dụ: ABC123XYZ |
data.udid | string | Bắt buộc | UDID thiết bị Ví dụ: 00008030-001234567890002E |
data.enabled | boolean | Bắt buộc | Trạng thái kích hoạt hiện tại Ví dụ: false |
data.yblack | string | Bắt buộc | Cờ trạng thái: Ysucc=bật, Yno=tắt Ví dụ: Yno |
data.status_name | string | Bắt buộc | Tên trạng thái Ví dụ: 禁用 |
data.status_code | number | Bắt buộc | Mã trạng thái: 1=bật, 0=tắt Ví dụ: 0 |
ip | string | Bắt buộc | Địa chỉ IP người yêu cầu Ví dụ: 192.168.1.100 |
ysucc | string | Bắt buộc | Cờ thành công, trả về "Ysucc" khi thành công Ví dụ: Ysucc |
Ví dụ phản hồi
{}
"code":1,
"msg":"Thiết bị đã bị tắt",
"time":1769675945,
"data":
{}
,"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"enabled":false,
"yblack":"Yno",
"status_name":"禁用",
"status_code":0
"ip":"192.168.1.100",
"ysucc":"Ysucc"
Bật thiết bị
Dùng action=enable để bật thiết bị
Bật thiết bị
{}
"code":1,
"msg":"Thiết bị đã được bật",
"time":1769675945,
"data":
{}
,"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"enabled":true,
"yblack":"Ysucc",
"status_name":"启用",
"status_code":1
"ip":"192.168.1.100",
"ysucc":"Ysucc"
Mã lỗi
Mã lỗi7 được định nghĩa
12Token không được để trống
Thiếu tham số Token
10Token không hợp lệ
Token không hợp lệ hoặc đã hết hạn
20Vui lòng cung cấp kid hoặc udid
Thiếu kid hoặc udid
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: viNgôn ngữ được hỗ trợ
zh, 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 GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disable" \
-H "X-Lang: vi"Lưu ý
- Khi có nhiều chứng chỉ cho một udid, dùng kid để chỉ định
- Thiết bị bị tắt không thể cài đặt
- Chỉ có thể thao tác trên thiết bị của bạn
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/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disableĐã khóa vào trang nàystringBắt buộc
Token API người dùng
string
KID thiết bị. Cung cấp kid hoặc udid
string
UDID thiết bị. Cung cấp kid hoặc udid
string
Hành động: enable, disable hoặc toggle. Mặc định là toggle