POST

v2.2.0stable

إضافة أجهزة متعددة

تسجيل عدة UDID دفعة واحدة مع إعدادات افتراضية وتجاوزات لكل عنصر. يمكن لكل عنصر استخدام الوضع الفوري أو الحجز.

POST/api/adddevice/batch

المصادقة:API Key

الحد:10/دقيقة

معلمات الطلب

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

اسم المعلمة	النوع	مطلوب	الوصف
`token`	string	اختياري	رمز API عام للمستخدم. يُستخدم عندما لا يوفر item/defaults رمزاً مثال: your_api_token_here
`mode`	string	اختياري	وضع الإضافة العام: instant أو review. الافتراضي instant ويمكن تجاوزه instantreview مثال: instant
`defaults`	object	اختياري	المعاملات الافتراضية لكل العناصر، مثل warranty/shtype/type/deviceType/beizhu/code/token/mode مثال: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	اختياري	مصفوفة الأجهزة. يتطلب كل عنصر udid ويمكنه تجاوز أي حقل افتراضي مثال: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	اختياري	مصفوفة UDID مبسطة تستخدم الإعدادات الافتراضية مثال: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	اختياري	قائمة UDID نصية مفصولة بفواصل أو أسطر جديدة مثال: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	اختياري	هل يستمر بعد فشل عنصر. الافتراضي true مثال: true

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

اسم المعلمة	النوع	مطلوب	الوصف
`code`	number	مطلوب	رمز الحالة: 1=تمت معالجة الطلب مثال: 1
`data.total`	number	مطلوب	إجمالي الأجهزة المطلوبة مثال: 2
`data.processed`	number	مطلوب	عدد العناصر التي تمت معالجتها مثال: 2
`data.success`	number	مطلوب	عدد النجاحات مثال: 1
`data.failed`	number	مطلوب	عدد الإخفاقات مثال: 1
`data.results`	array	مطلوب	نتائج كل عنصر مثال:

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

{

"code":1,

"msg":"تمت معالجة الطلب المجمع",

"time":1769675945,

"data":

{

"total":2,

"processed":2,

"success":1,

"failed":1,

"continueOnError":true,

"results":

[

{

"index":0,

"udid":"00008030-001234567890ABCD",

"mode":"instant",

"success":true,

"code":1,

"msg":"添加成功",

"http_status":200,

"data":

{

"id":"AB12CD34",

"pool":0,

"addtime":1706500000,

"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",

"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"

}

{

"index":1,

"udid":"invalid-udid",

"mode":"review",

"success":false,

"code":0,

"msg":"UDID格式错误",

"http_status":200

}

]

}

رموز الخطأ

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

0

JSON غير صالح

جسم الطلب ليس JSON صالحاً

0

items أو udids مطلوب

لم يتم توفير أي جهاز

0

عدد العناصر كبير جداً، الحد 50

الحد الأقصى 50 جهازاً لكل دفعة

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

خصص لغة استجابة 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/batch" \
  -H "X-Lang: ar" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_api_token_here",
    "mode": "instant",
    "defaults": "{\"warranty\":\"1\",\"type\":\"0\",\"deviceType\":\"iphone\",\"beizhu\":\"batch\"}",
    "items": "[{\"udid\":\"00008030-001234567890ABCD\"},{\"udid\":\"00008020-00ABCDEF12345678\",\"mode\":\"review\",\"warranty\":\"2\",\"beizhu\":\"VIP device\"}]",
    "udids": "[\"00008030-001234567890ABCD\",\"00008020-00ABCDEF12345678\"]",
    "udids_text": "00008030-001234567890ABCD\n00008020-00ABCDEF12345678",
    "continue_on_error": true
  }'

ملاحظات

تستخدم هذه الواجهة منطق /api/adddevice و /api/addyydevice وتعالج العناصر واحداً تلو الآخر
يجب أن يكون الطلب JSON ويتم تحويل معاملات كل عنصر داخلياً
defaults توفر معاملات مشتركة وحقول item لها أولوية أعلى
mode يدعم instant/review
الحد الأقصى 50 عنصراً لكل طلب ومعدل 10 طلبات/دقيقة

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

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

POSThttps://testypro.iwai.cc/api/adddevice/batchمقفل على هذا الموقع

tokenstring

رمز API عام للمستخدم. يُستخدم عندما لا يوفر item/defaults رمزاً

modestring

وضع الإضافة العام: instant أو review. الافتراضي instant ويمكن تجاوزه

defaultsobject

المعاملات الافتراضية لكل العناصر، مثل warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

مصفوفة الأجهزة. يتطلب كل عنصر udid ويمكنه تجاوز أي حقل افتراضي

udidsarray

مصفوفة UDID مبسطة تستخدم الإعدادات الافتراضية

udids_textstring

قائمة UDID نصية مفصولة بفواصل أو أسطر جديدة

continue_on_errorboolean

هل يستمر بعد فشل عنصر. الافتراضي true