POST
v2.2.0stable

Batch Add Devices

Batch register multiple UDIDs with flexible defaults and per-item overrides. Each item can use instant or reservation mode.

POST/api/adddevice/batch
অনুমোদন:API Key
সীমা:10/minute

অনুরোধ করা পরামিতি

সকল পরামিতি অনুসন্ধান বা মৃতদেহের মাধ্যমে অতিক্রম করা যাবে

পরামিতিধরনআবশ্যকবিবরণ
token
stringবিকল্প
Global user API token. Used when item/defaults does not provide token
উদাহরণ: your_api_token_here
mode
stringবিকল্প
Global add mode: instant or review. Default is instant; can be overridden by defaults.mode or item.mode
instantreview
উদাহরণ: instant
defaults
objectবিকল্প
Default params for all items. Supports single add API params such as warranty/shtype/type/deviceType/beizhu/code/token/mode
উদাহরণ: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
items
arrayবিকল্প
Device item array. Each item requires udid and can override any defaults field. Provide at least one of items/udids/udids_text
উদাহরণ: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
udids
arrayবিকল্প
Simplified UDID array. Uses defaults/global params for all devices
উদাহরণ: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
udids_text
stringবিকল্প
Text UDID list separated by comma, semicolon, whitespace, or new lines
উদাহরণ: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
continue_on_error
booleanবিকল্প
Whether to continue after an item fails. Default true
উদাহরণ: true

প্রতিক্রিয়া

পরামিতিধরনআবশ্যকবিবরণ
code
numberআবশ্যক
Status code: 1=batch request processed
উদাহরণ: 1
data.total
numberআবশ্যক
Total requested devices
উদাহরণ: 2
data.processed
numberআবশ্যক
Actually processed item count
উদাহরণ: 2
data.success
numberআবশ্যক
Success count
উদাহরণ: 1
data.failed
numberআবশ্যক
Failure count
উদাহরণ: 1
data.results
arrayআবশ্যক
Per-item results with index/udid/mode/success/code/msg/data/raw
উদাহরণ:
রেসপন্স উদাহরণ
{
"code":1,
"msg":"Batch request processed",
"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
Invalid JSON body
Request body is not valid JSON
0
items or udids is required
No device provided
0
Too many items, maximum is 50
Maximum 50 devices per batch

বহিরাগত ভাষা

X-Lang হেডারের সাথে API প্রতিক্রিয়া গ্রহণ করুন। টি কোড স্বয়ংক্রিয়ভাবে আপনার বর্তমান অবস্থানের জন্য ব্যবহার করা হচ্ছে।

প্রস্তাবিত হেডার
X-Lang: bn
সমর্থিত ভাষা
zh, en, zh-TW, vi, ar, es, ru

সমর্থিত ভাষাও সমর্থিত নয়; X-Lang এর অগ্রাধিকার গ্রহণ করা হয়। ওয়েব-সাইট ফাইলটির সাহায্যে সমর্থিত হয়।

কোড উদাহরণ

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/batch" \
  -H "X-Lang: bn" \
  -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 提供公共参数,items 中同名字段优先级更高
  • mode 支持 instant/review;也兼容 reservation/reserve/yy/addyydevice 作为 review
  • 单次最多 50 条,接口本身限流 10 次/分钟

কনসোলের মধ্যে এটি চেষ্টা করুন

বাগ পূরণ করুন এবং এটি পরীক্ষা করুন। এই সাইটের API- এ কেবল অনুরোধ করা হয়; URL- টি লক করা হয়েছে এবং আপনার বর্তমান লগ- ইন কুকি অন্তর্ভুক্ত করা যাবে না।

POSThttps://testypro.iwai.cc/api/adddevice/batchএই সাইটের লক করা হয়েছে
string

Global user API token. Used when item/defaults does not provide token

string

Global add mode: instant or review. Default is instant; can be overridden by defaults.mode or item.mode

object

Default params for all items. Supports single add API params such as warranty/shtype/type/deviceType/beizhu/code/token/mode

array

Device item array. Each item requires udid and can override any defaults field. Provide at least one of items/udids/udids_text

array

Simplified UDID array. Uses defaults/global params for all devices

string

Text UDID list separated by comma, semicolon, whitespace, or new lines

boolean

Whether to continue after an item fails. Default true