GETPOST

v1.0.0stable

Set Device Status

Update the status of a device using token authentication

GET | POST/api/device/status

Auth:API Key

Granica:60/minute

Parametry żądania

Wszystkie parametry mogą być przekazywane za pośrednictwem zapytania lub ciała

Parametr	Rodzaj	Wymagane	Opis
`token`	string	Wymagane	User API token Przykład: your_api_token_here
`kid`	string	Opcjonalnie	Device KID. Provide either kid or udid Przykład: ABC123XYZ
`udid`	string	Opcjonalnie	Device UDID. Provide either kid or udid Przykład: 00008030-001234567890002E
`action`	string	Opcjonalnie	Action: enable, disable, or toggle. Default is toggle enabledisabletoggle Przykład: disable

Odpowiedź

Parametr	Rodzaj	Wymagane	Opis
`code`	number	Wymagane	Status code: 1=success, others=failure Przykład: 1
`msg`	string	Wymagane	Response message Przykład: 设备已禁用
`time`	number	Wymagane	Server timestamp (Unix seconds) Przykład: 1769675945
`data`	object	Wymagane	Response payload
`data.id`	number	Wymagane	Device ID Przykład: 12345
`data.kid`	string	Wymagane	Device KID Przykład: ABC123XYZ
`data.udid`	string	Wymagane	Device UDID Przykład: 00008030-001234567890002E
`data.enabled`	boolean	Wymagane	Current enabled status Przykład: false
`data.yblack`	string	Wymagane	Status flag: Ysucc=enabled, Yno=disabled Przykład: Yno
`data.status_name`	string	Wymagane	Status name Przykład: 禁用
`data.status_code`	number	Wymagane	Status code: 1=enabled, 0=disabled Przykład: 0
`ip`	string	Wymagane	Requester IP address Przykład: 192.168.1.100
`ysucc`	string	Wymagane	Success flag, returns "Ysucc" on success Przykład: Ysucc

Przykład odpowiedzi

{

"code":1,

"msg":"Device disabled",

"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"

}

Enable Device

Use action=enable to enable the device

Enable Device

{

"code":1,

"msg":"Device enabled",

"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"

}

Kod błędu

Kod błędu7 zdefiniowane

12

Token is required

Token parameter is missing

10

Invalid token

Invalid or expired token

20

Please provide kid or udid

Missing kid or udid

Język odpowiedzi

Dostosuj język odpowiedzi API do nagłówka X- Lang. Poniższe przykłady kodów automatycznie korzystają z aktualnego języka strony.

Zalecany nagłówek

X-Lang: pl

Obsługiwane języki

zh, en, zh-TW, vi, ar, es, ru

Obsługiwane jest również Accept- Language; X- Lang ma pierwszeństwo. Nieobsługiwane języki podążają za zapasami języka strony.

Przykłady kodów

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: pl"

Uwagi

当一个 udid 有多个证书时，需要使用 kid 精确指定
禁用后的设备将无法进行安装操作
只能操作属于自己的设备

Spróbuj w konsoli

Wypełnij poniższe parametry i wyślij wniosek o przetestowanie. Żądania są kierowane tylko do API tej witryny; adres URL jest zablokowany i nie może być zmieniony, a obecne pliki cookie logowania są włączone.

https://testypro.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disable

Zamknięte na tej stronie

tokenstringWymagane

User API token

kidstring

Device KID. Provide either kid or udid

udidstring

Device UDID. Provide either kid or udid

actionstring

Action: enable, disable, or toggle. Default is toggle