GETPOST
v1.0.0stableتحديث ملاحظة الجهاز
تحديث ملاحظة الجهاز باستخدام مصادقة الرمز
GET | POST
/api/device/remarkالمصادقة: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 |
remark | string | مطلوب | محتوى الملاحظة الجديد (مرر سلسلة فارغة للمسح) مثال: 我的iPhone设备 |
معلمات الاستجابة
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
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.remark | string | مطلوب | الملاحظة المحدثة مثال: 我的iPhone设备 |
ip | string | مطلوب | عنوان IP للطالب مثال: 192.168.1.100 |
ysucc | string | مطلوب | علامة النجاح، ترجع "Ysucc" عند النجاح مثال: Ysucc |
مثال الاستجابة
{}
"code":1,
"msg":"تم تحديث الملاحظة بنجاح",
"time":1769675945,
"data":
{}
,"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"remark":"我的iPhone设备"
"ip":"192.168.1.100",
"ysucc":"Ysucc"
رموز الخطأ
رموز الخطأ5 معرّف
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/remark?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&remark=%E6%88%91%E7%9A%84iPhone%E8%AE%BE%E5%A4%87" \
-H "X-Lang: ar"ملاحظات
- عندما توجد عدة شهادات لنفس udid، استخدم kid للتحديد
- يمكنك فقط تعديل أجهزتك الخاصة
جرّب في وحدة التحكم
املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.
https://testypro.iwai.cc/api/device/remark?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E&remark=%E6%88%91%E7%9A%84iPhone%E8%AE%BE%E5%A4%87مقفل على هذا الموقعstringمطلوب
رمز API للمستخدم
string
KID للجهاز. قدم إما kid أو udid
string
UDID للجهاز. قدم إما kid أو udid
stringمطلوب
محتوى الملاحظة الجديد (مرر سلسلة فارغة للمسح)