GETPOST
v2.2.0stable

إضافة جهاز V2

واجهة موحدة لإضافة جهاز واحد. يمكن التبديل بين الوضع الفوري ووضع الحجز بمعامل واحد مع بقاء الواجهات القديمة متاحة.

GET | POST/api/adddevice/v2
المصادقة:API Key
الحد:60/دقيقة

معلمات الطلب

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

اسم المعلمةالنوعمطلوبالوصف
token
stringمطلوب
رمز API للمستخدم
مثال: your_api_token_here
udid
stringمطلوب
UDID للجهاز (يجب أن يكون 25 أو 40 حرفاً)
مثال: 00008030-001234567890ABCD
mode
stringاختياري
وضع الإضافة: instant أو review. الافتراضي instant
instantreview
مثال: instant
add_mode
stringاختياري
اسم بديل لـ mode وله أولوية أعلى
instantreview
مثال: review
force
booleanاختياري
إضافة إجبارية. true/1/yes/y/on يتجاوز فحص الجهاز الموجود وفترة الحظر
مثال: true
warranty
stringاختياري
نوع الضمان: 0/1/2/3/4/6. وضع review لا يدعم 4/6
012346
مثال: 1
shtype
stringاختياري
اسم بديل قديم لـ warranty
012346
مثال: 1
type
stringاختياري
نوع المجموعة: 0 عامة، 1 خاصة
01
مثال: 0
deviceType
stringاختياري
نوع الجهاز: iphone أو ipad
iphoneipad
مثال: iphone
beizhu
stringاختياري
ملاحظة
مثال: 测试设备
code
stringاختياري
رمز التفعيل (اختياري)
مثال: ABC123XYZ

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

اسم المعلمةالنوعمطلوبالوصف
code
numberمطلوب
رمز الحالة
مثال: 1
msg
stringمطلوب
رسالة الاستجابة
مثال: 添加成功
data.id
stringمطلوب
معرف الشهادة / الحجز
مثال: AB12CD34
data.mobileprovision
stringمطلوب
mobileprovision بترميز Base64 وقد يكون فارغاً أثناء المراجعة
مثال: Base64EncodedString...
data.p12
stringمطلوب
شهادة P12 بترميز Base64
مثال: Base64EncodedString...
مثال الاستجابة
{
"code":1,
"msg":"تمت إضافة الجهاز بنجاح",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

رموز الخطأ

رموز الخطأ3 معرّف
0
رمز غير صالح
رمز غير صالح أو منتهي الصلاحية
0
تنسيق UDID غير صالح
يجب أن يكون طول UDID 25 أو 40
0
ضمن فترة الإضافة الإجبارية
مرر force=true لمحاولة إضافة جديدة

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

خصص لغة استجابة 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/adddevice/v2" \
  -H "X-Lang: ar" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_api_token_here",
    "udid": "00008030-001234567890ABCD",
    "mode": "instant",
    "add_mode": "review",
    "force": true,
    "warranty": "1",
    "shtype": "1",
    "type": "0",
    "deviceType": "iphone",
    "beizhu": "测试设备",
    "code": "ABC123XYZ"
  }'

ملاحظات

  • تبقى الواجهات القديمة /api/adddevice و /api/addyydevice متاحة ومتوافقة
  • mode=instant يستخدم منطق الإضافة الفورية و mode=review يستخدم منطق الحجز
  • يدعم Query و form و JSON body، ويوصى بـ JSON لـ V2
  • force=true يتجاوز الفحوصات المحلية فقط ولا يضمن قبول Apple للتكرار
  • وضع review يتبع قيود واجهة الحجز

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

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

https://testypro.iwai.cc/api/adddevice/v2?token=your_api_token_here&udid=00008030-001234567890ABCD&mode=instant&add_mode=review&force=true&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZمقفل على هذا الموقع
stringمطلوب

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

stringمطلوب

UDID للجهاز (يجب أن يكون 25 أو 40 حرفاً)

string

وضع الإضافة: instant أو review. الافتراضي instant

string

اسم بديل لـ mode وله أولوية أعلى

boolean

إضافة إجبارية. true/1/yes/y/on يتجاوز فحص الجهاز الموجود وفترة الحظر

string

نوع الضمان: 0/1/2/3/4/6. وضع review لا يدعم 4/6

string

اسم بديل قديم لـ warranty

string

نوع المجموعة: 0 عامة، 1 خاصة

string

نوع الجهاز: iphone أو ipad

string

ملاحظة

string

رمز التفعيل (اختياري)