GETPOST
v2.1.0stableإضافة جهاز (حجز/مراجعة)
تسجيل جهاز في وضع الحجز. قد يكون mobileprovision فارغاً أثناء انتظار مراجعة Apple
GET | POST
/api/addyydeviceالمصادقة:API Key
الحد:30/دقيقة
معلمات الطلب
يمكن تمرير جميع المعلمات عبر Query أو Body
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
token | string | مطلوب | رمز API للمستخدم مثال: your_api_token_here |
udid | string | مطلوب | UDID للجهاز. يجب أن يكون 25 أو 40 حرفاً مثال: 00008030-001234567890ABCD |
warranty | string | اختياري | نوع الضمان: 0/1/2/3/4/6. يُنصح بتمريره صراحةً 012346 مثال: 1 |
shtype | string | اختياري | اسم بديل لـ warranty، يُستخدم فقط عندما يكون warranty فارغاً 012346 مثال: 1 |
type | string | اختياري | نوع المجموعة: 0=عامة، 1=خاصة. الافتراضي 0 01 مثال: 0 |
deviceType | string | اختياري | نوع الجهاز: iphone أو ipad. الافتراضي iphone iphoneipad مثال: iphone |
beizhu | string | اختياري | ملاحظة، حتى 40 حرفاً مثال: 预约测试设备 |
معلمات الاستجابة
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
code | number | مطلوب | رمز الحالة: 1=نجاح، 0=فشل مثال: 1 |
msg | string | مطلوب | رسالة الاستجابة مثال: 添加成功 |
time | number | مطلوب | الطابع الزمني للخادم (ثواني Unix) مثال: 1769675945 |
data | object | مطلوب | بيانات الاستجابة |
data.id | string | مطلوب | رقم الحجز / معرف الشهادة (عادةً 5 أحرف أبجدية رقمية) مثال: A1B2C |
data.pool | number | مطلوب | المجموعة: 0=عامة، 1=خاصة مثال: 0 |
data.addtime | number | مطلوب | وقت الإضافة (Unix) مثال: 1706500000 |
data.mobileprovision | string | مطلوب | mobileprovision بترميز Base64 (قد يكون فارغاً أثناء المراجعة) مثال: Base64EncodedString... |
data.p12 | string | مطلوب | شهادة P12 بترميز Base64 مثال: Base64EncodedString... |
data.state | boolean | مطلوب | حالة صلاحية الشهادة (يتم إرجاعها في بعض الفروع) مثال: true |
ysucc | string | مطلوب | علامة النجاح، ترجع "Ysucc" عند النجاح مثال: Ysucc |
مثال الاستجابة
{}
"code":1,
"msg":"تم الحجز بنجاح",
"time":1769675945,
"data":
{}
,"id":"A1B2C",
"pool":0,
"addtime":1706500000,
"mobileprovision":"",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
"ysucc":"Ysucc"
رموز الخطأ
رموز الخطأ4 معرّف
0رمز غير صالح
رمز غير صالح أو منتهي الصلاحية
0تنسيق UDID غير صالح
يجب أن يكون طول UDID ـ 25 أو 40 حرفاً
0الرصيد غير كافٍ
رصيد غير كافٍ
لغة الاستجابة
خصص لغة استجابة 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/addyydevice" \
-H "X-Lang: ar" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E9%A2%84%E7%BA%A6%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87"ملاحظات
- أرسل المعاملات عبر Query أو x-www-form-urlencoded. لا يتم تحليل JSON Body
- shtype هو اسم بديل قديم لـ warranty، يُستخدم فقط عندما يكون warranty فارغاً
- mobileprovision الفارغ يعني عادةً أن المراجعة قيد الانتظار، تحقق من الحالة عبر واجهة قائمة الأجهزة
جرّب في وحدة التحكم
املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.
https://testypro.iwai.cc/api/addyydevice?token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E9%A2%84%E7%BA%A6%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87مقفل على هذا الموقعstringمطلوب
رمز API للمستخدم
stringمطلوب
UDID للجهاز. يجب أن يكون 25 أو 40 حرفاً
string
نوع الضمان: 0/1/2/3/4/6. يُنصح بتمريره صراحةً
string
اسم بديل لـ warranty، يُستخدم فقط عندما يكون warranty فارغاً
string
نوع المجموعة: 0=عامة، 1=خاصة. الافتراضي 0
string
نوع الجهاز: iphone أو ipad. الافتراضي iphone
string
ملاحظة، حتى 40 حرفاً