GETPOST
v1.0.0stableИзменить Статус Устройства
Обновите статус устройства, используя аутентификацию по токену
GET | POST
/api/device/statusАутентификация:API Key
Лимит:60/минут
Параметры запроса
Все параметры можно передавать через Query или Body
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
token | string | Обязательный | Токен API пользователя Пример: your_api_token_here |
kid | string | Опционально | KID устройства. Укажите либо kid, либо UDID Пример: ABC123XYZ |
udid | string | Опционально | UDID устройства. Укажите либо kid, либо UDID Пример: 00008030-001234567890002E |
action | string | Опционально | Действие: включить, отключить или переключить. По умолчанию переключить enabledisabletoggle Пример: disable |
Ответ
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
code | number | Обязательный | Код состояния: 1=успех, остальные=неудача Пример: 1 |
msg | string | Обязательный | Ответное сообщение Пример: 设备已禁用 |
time | number | Обязательный | Временная метка сервера (Unix в секундах) Пример: 1769675945 |
data | object | Обязательный | Ответ (payload) |
data.id | number | Обязательный | Идентификатор устройства Пример: 12345 |
data.kid | string | Обязательный | KID устройства Пример: ABC123XYZ |
data.udid | string | Обязательный | UDID устройства Пример: 00008030-001234567890002E |
data.enabled | boolean | Обязательный | Текущий статус включения Пример: false |
data.yblack | string | Обязательный | Флаг статуса: Ysucc=включено, Yno=выключено Пример: Yno |
data.status_name | string | Обязательный | Название статуса Пример: 禁用 |
data.status_code | number | Обязательный | Код статуса: 1=включено, 0=выключено Пример: 0 |
ip | string | Обязательный | IP-адрес запрашивающего Пример: 192.168.1.100 |
ysucc | string | Обязательный | Флаг успеха, возвращает "Ysucc" при успешном выполнении Пример: Ysucc |
Пример ответа
{}
"code":1,
"msg":"Устройство отключено",
"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"
Включить устройство
Используйте action=enable, чтобы включить устройство
Включить устройство
{}
"code":1,
"msg":"Устройство включено",
"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"
Коды ошибок
Коды ошибок7 определено
12Требуется токен
Параметр токена отсутствует
10Недействительный токен
Недействительный или просроченный токен
20Пожалуйста, укажите kid или UDID
Отсутствует kid или UDID
X-Lang: enzh, en, zh-TW, vi, arПримеры кода
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: en"Примечания
- Когда для одного UDID существует несколько сертификатов, используйте kid для указания
- Отключенные устройства не могут выполнять установку
- Можно работать только со своими устройствами
Попробуйте в Консоли
Заполните параметры ниже и отправьте запрос для тестирования. Запросы отправляются только на API этого сайта; URL зафиксирован и не может быть изменен, а текущий файл cookie для входа включен.
https://testypro.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disableЗаблокировано для этого сайтаstringОбязательный
Токен API пользователя
string
KID устройства. Укажите либо kid, либо UDID
string
UDID устройства. Укажите либо kid, либо UDID
string
Действие: включить, отключить или переключить. По умолчанию переключить