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 | اختياري | الإجراء: enable أو disable أو toggle. الافتراضي toggle enabledisabletoggle مثال: disable |
معلمات الاستجابة
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
code | number | مطلوب | رمز الحالة: 1=نجاح، غيره=فشل مثال: 1 |
msg | string | مطلوب | رسالة الاستجابة مثال: 设备已禁用 |
time | number | مطلوب | الطابع الزمني للخادم (ثواني Unix) مثال: 1769675945 |
data | object | مطلوب | بيانات الاستجابة |
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الرمز مطلوب
معامل Token مفقود
10الرمز غير صالح
رمز غير صالح أو منتهي الصلاحية
20يرجى تقديم kid أو udid
kid أو udid مفقود
لغة الاستجابة
خصص لغة استجابة API باستخدام ترويسة X-Lang. تستخدم أمثلة الكود أدناه لغة الموقع الحالية تلقائيًا.
الترويسة الموصى بها
X-Lang: arاللغات المدعومة
zh, en, zh-TW, vi, arيمكن أيضًا استخدام Accept-Language؛ وتكون الأولوية لـ 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: ar"ملاحظات
- عندما توجد عدة شهادات لنفس udid، استخدم kid للتحديد
- الأجهزة المعطلة لا يمكنها التثبيت
- يمكنك فقط تشغيل أجهزتك الخاصة
جرّب في وحدة التحكم
املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.
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
الإجراء: enable أو disable أو toggle. الافتراضي toggle