Torna alla homeDocumentazione API
Lingua: Italiano
简体中文English繁體中文（台灣）繁體中文（香港）Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दीItalianoPolskiУкраїнськаFilipinoবাংলা
Torna a 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
Limite:60/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

ParametroTipoObbligoDescrizione
token
stringObbligo
User API token
Esempio: your_api_token_here
kid
stringFacoltativo
Device KID. Provide either kid or udid
Esempio: ABC123XYZ
udid
stringFacoltativo
Device UDID. Provide either kid or udid
Esempio: 00008030-001234567890002E
action
stringFacoltativo
Action: enable, disable, or toggle. Default is toggle
enabledisabletoggle
Esempio: disable

Risposta

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

Codici di errore

Codici di errore7 definito
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

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata
X-Lang: it
Lingue supportate
zh, en, zh-TW, vi, ar, es, ru

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

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

Note

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

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

https://testypro.iwai.cc/api/device/status?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&action=disableBloccato a questo sito
stringObbligo

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