GETPOST
v1.0.0stable

デバイス状態更新

トークン認証を使用してデバイスのステータスを更新する

GET | POST/api/device/status
auth:API Key
制限:60/分

リクエストパラメータ

すべてのパラメータは、クエリまたは本文を介して渡すことができます

パラメータータイプ必須内容
token
string必須
API トークン
例: your_api_token_here
kid
stringオプション
デバイスキッド。キッドまたは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必須
応答ペイロード
data.id
number必須
デバイスID
例: 12345
data.kid
string必須
デバイスキッド
例: 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 defined
12
トークンは必須です。
トークンパラメータがありません
10
無効なトークン
無効なまたは期限切れの Nonce トークン!
20
KIDまたはUDIDを入力してください
KIDまたはUDIDがありません

応答言語

X-Lang ヘッダーで API 応答言語をカスタマイズします。以下のコード例は、現在のサイト言語を自動的に使用します。

推奨ヘッダー
X-Lang: ja
対応言語
zh, en, zh-TW, vi, ar, es, ru

アクセプト言語もサポートしています。X-Langは優先します。サポートされていない言語はサイトの言語のフォールバックに従ってください。

コード例

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

注

  • 1つの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

デバイスキッド。キッドまたはUDIDのいずれかを提供します

string

デバイスUDID。KIDまたはUDIDのいずれかを指定します

string

アクション:有効、無効、または切り替え。デフォルトは切り替え