Back to HomeAPI Docs
Language: English
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
Back to Docs
GETPOST
v1.0.0stable

Set Device Status

Update the status of a device using token authentication

GET | POST/api/device/status
Auth:API Key
Limit:60/minute

Request Parameters

All parameters can be passed via Query or Body

ParameterTypeRequiredDescription
token
stringRequired
User API token
Example: your_api_token_here
kid
stringOptional
Device KID. Provide either kid or udid
Example: ABC123XYZ
udid
stringOptional
Device UDID. Provide either kid or udid
Example: 00008030-001234567890002E
action
stringOptional
Action: enable, disable, or toggle. Default is toggle
enabledisabletoggle
Example: disable

Response

ParameterTypeRequiredDescription
code
numberRequired
Status code: 1=success, others=failure
Example: 1
msg
stringRequired
Response message
Example: 设备已禁用
time
numberRequired
Server timestamp (Unix seconds)
Example: 1769675945
data
objectRequired
Response payload
data.id
numberRequired
Device ID
Example: 12345
data.kid
stringRequired
Device KID
Example: ABC123XYZ
data.udid
stringRequired
Device UDID
Example: 00008030-001234567890002E
data.enabled
booleanRequired
Current enabled status
Example: false
data.yblack
stringRequired
Status flag: Ysucc=enabled, Yno=disabled
Example: Yno
data.status_name
stringRequired
Status name
Example: 禁用
data.status_code
numberRequired
Status code: 1=enabled, 0=disabled
Example: 0
ip
stringRequired
Requester IP address
Example: 192.168.1.100
ysucc
stringRequired
Success flag, returns "Ysucc" on success
Example: Ysucc
Response Example
{
"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"
}

Error Codes

Error Codes7 defined
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

Response Language

Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.

Recommended Header
X-Lang: en
Supported Languages
zh, en, zh-TW, vi, ar

Accept-Language is also supported; X-Lang takes priority. Unsupported languages fall back to English.

Code Examples

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"

Notes

  • When multiple certificates exist for one udid, use kid to specify
  • Disabled devices cannot perform installation
  • Can only operate on your own devices

Try it in Console

Fill in the parameters below and send a request to test. Requests only go to this site's API; the URL is locked and cannot be changed, and your current login cookie is included.

https://testypro.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disableLocked to this site
stringRequired

User API token

string

Device KID. Provide either kid or udid

string

Device UDID. Provide either kid or udid

string

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