GETPOST

v1.0.0stable

قائمة الأجهزة

الاستعلام عن قائمة أجهزة المستخدم مع التصفح والتصفية حسب الحالة.

GET | POST/api/device/list

المصادقة:API Key

معلمات الطلب

يمكن تمرير جميع المعلمات عبر Query أو Body

اسم المعلمة	النوع	مطلوب	الوصف
`token`	string	مطلوب	رمز API للمستخدم مثال: your_api_token_here
`page`	number	اختياري	رقم الصفحة، الافتراضي 1 مثال: 1
`per_page`	number	اختياري	عدد العناصر في الصفحة، الافتراضي 20 والحد الأقصى 100 مثال: 20
`zt`	string	اختياري	تصفية الحالة: all أو normal أو hidden أو reviewing أو update allnormalhiddenreviewingupdate مثال: all
`shtype`	string	اختياري	تصفية نوع خدمة ما بعد البيع، افصل القيم بفواصل مثال: 1,2

معلمات الاستجابة

اسم المعلمة	النوع	مطلوب	الوصف
`code`	number	مطلوب	رمز الحالة: 1=نجاح مثال: 1
`msg`	string	مطلوب	رسالة الاستجابة مثال: 获取成功
`data.devices`	array	مطلوب	قائمة الأجهزة
`data.devices[].kid`	string	مطلوب	KID للجهاز مثال: KID001
`data.devices[].udid`	string	مطلوب	UDID للجهاز مثال: 00008030-001234567890002E
`data.devices[].pname`	string	مطلوب	اسم الجهاز مثال: iPhone 15 Pro
`data.devices[].zt`	string	مطلوب	حالة الجهاز أو الشهادة مثال: normal
`data.devices[].ytime`	number	مطلوب	وقت انتهاء العضوية، 0 يعني دائم مثال: 1772267945
`data.devices[].enabled`	boolean	مطلوب	هل الجهاز مفعّل مثال: true
`data.total`	number	مطلوب	إجمالي الأجهزة المطابقة مثال: 36
`data.page`	number	مطلوب	رقم الصفحة الحالية مثال: 1
`data.per_page`	number	مطلوب	عدد العناصر الفعلي في الصفحة، الحد الأقصى 100 مثال: 20
`data.last_page`	number	مطلوب	رقم آخر صفحة مثال: 2
`data.count_normal`	number	مطلوب	عدد الأجهزة الطبيعية مثال: 30
`data.count_hidden`	number	مطلوب	عدد الأجهزة المتوقفة أو المحظورة مثال: 4
`data.count_reviewing`	number	مطلوب	عدد الأجهزة قيد المراجعة مثال: 2

مثال الاستجابة

{

"code":1,

"msg":"نجاح",

"time":1769675945,

"data":

{

"devices":

[

{

"kid":"KID001",

"udid":"00008030-001234567890002E",

"pname":"iPhone 15 Pro",

"type":"iphone",

"shtype":1,

"zt":"normal",

"ytime":1772267945,

"model":"iPhone16,1",

"beizhu":"主力设备",

"enabled":true

}

]

"total":36,

"page":1,

"per_page":20,

"last_page":2,

"count_normal":30,

"count_hidden":4,

"count_reviewing":2

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

استعلام الصفحة الأولى

الحصول على أول 20 جهازاً للمستخدم الحالي

استعلام الصفحة الأولى

{

"token":"your_api_token_here",

"page":1,

"per_page":20

}

الأجهزة الطبيعية فقط

استخدم zt=normal لإرجاع الأجهزة الطبيعية فقط

الأجهزة الطبيعية فقط

{

"token":"your_api_token_here",

"zt":"normal",

"page":1,

"per_page":50

}

الأجهزة قيد المراجعة

استخدم zt=reviewing للأجهزة قيد المراجعة

الأجهزة قيد المراجعة

{

"token":"your_api_token_here",

"zt":"reviewing"

}

الحد الأقصى 100 عنصر في الصفحة

إذا كان per_page أكبر من 100 فسيتم ضبطه تلقائياً إلى 100

الحد الأقصى 100 عنصر في الصفحة

{

"token":"your_api_token_here",

"page":1,

"per_page":100

}

رموز الخطأ

رموز الخطأ2 معرّف

12

الرمز مطلوب

معامل token مفقود

10

رمز غير صالح

الرمز غير موجود أو حالة المستخدم لا تسمح بالوصول

لغة الاستجابة

خصص لغة استجابة API باستخدام ترويسة X-Lang. تستخدم أمثلة الكود أدناه لغة الموقع الحالية تلقائيًا.

الترويسة الموصى بها

X-Lang: ar

اللغات المدعومة

zh, en, zh-TW, vi, ar

يمكن أيضًا استخدام Accept-Language؛ وتكون الأولوية لـ X-Lang. تعود اللغات غير المدعومة إلى الإنجليزية.

أمثلة الكود

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/list" \
  -H "X-Lang: ar" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2"

ملاحظات

تعيد القائمة أجهزة مستخدم الرمز الحالي فقط
الحد الأقصى لـ per_page هو 100 وسيتم ضبط القيم الأكبر تلقائياً إلى 100
zt=hidden يشمل حالات التوقف والحاجة للتحديث، و zt=reviewing يعيد الأجهزة قيد المراجعة أو الحجز

جرّب في وحدة التحكم

املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.

https://testypro.iwai.cc/api/device/list?token=your_api_token_here&page=1&per_page=20&zt=all&shtype=1%2C2مقفل على هذا الموقع

tokenstringمطلوب

رمز API للمستخدم

pagenumber

رقم الصفحة، الافتراضي 1

per_pagenumber

عدد العناصر في الصفحة، الافتراضي 20 والحد الأقصى 100

ztstring

تصفية الحالة: all أو normal أو hidden أو reviewing أو update

shtypestring

تصفية نوع خدمة ما بعد البيع، افصل القيم بفواصل