GETPOST
v2.1.0stable

إضافة جهاز (فوري)

تسجيل UDID للجهاز وإرجاع mobileprovision و P12 فوراً

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

معلمات الطلب

يمكن تمرير جميع المعلمات عبر 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
stringاختياري
رمز التفعيل (اختياري)
مثال: ABC123XYZ

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

اسم المعلمةالنوعمطلوبالوصف
code
numberمطلوب
رمز الحالة: 1=نجاح، 0=فشل
مثال: 1
msg
stringمطلوب
رسالة الاستجابة
مثال: 添加成功
time
numberمطلوب
الطابع الزمني للخادم (ثواني Unix)
مثال: 1769675945
data
objectمطلوب
بيانات الاستجابة
data.id
stringمطلوب
معرف الشهادة (8 أحرف)
مثال: AB12CD34
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
data.reused
booleanمطلوب
هل تم إعادة استخدام شهادة موجودة (يتم إرجاعها فقط عند توفير الرمز وإمكانية إعادة الاستخدام لنفس الرمز و UDID)
مثال: true
ysucc
stringمطلوب
علامة النجاح، ترجع "Ysucc" عند النجاح
مثال: Ysucc
مثال الاستجابة
{
"code":1,
"msg":"تمت إضافة الجهاز بنجاح",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

رموز الخطأ

رموز الخطأ5 معرّف
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/adddevice" \
  -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=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZ"

ملاحظات

  • يدعم GET و POST (يظهر المثال POST)
  • أرسل المعاملات عبر Query أو x-www-form-urlencoded. لا يتم تحليل JSON Body
  • shtype هو اسم بديل قديم لـ warranty، يُستخدم فقط عندما يكون warranty فارغاً
  • يتم التحقق من UDID بالطول فقط (25 أو 40 حرفاً)
  • mobileprovision و p12 بترميز Base64، قم بفك الترميز وحفظهما كملفات
  • warranty=4 غير مدعوم مع type=1

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

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

https://testypro.iwai.cc/api/adddevice?token=your_api_token_here&udid=00008030-001234567890ABCD&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

نوع الضمان: 0/1/2/3/4/6. يُنصح بتمريره صراحةً. القيم المفقودة أو غير الصالحة تُعامَل كالنوع القياسي للتسعير

string

اسم بديل لـ warranty، يُستخدم فقط عندما يكون warranty فارغاً

string

نوع المجموعة: 0=عامة، 1=خاصة. الافتراضي 0

string

نوع الجهاز: iphone أو ipad. الافتراضي iphone

string

ملاحظة (حتى 40 حرفاً، يتم اقتطاعها إذا زادت)

string

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