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

Ang Auth:API Key

Hangganan:10/minute

Kahilingan ng mga Parameter

Ang lahat ng parameter ay maaaring ipasa sa pamamagitan ng Query o Body

Parameter	Uri	Kailangan	Paglalarawan
`token`	string	Mapagpipilian	Global user API token. Used when item/defaults does not provide token Halimbawa: your_api_token_here
`mode`	string	Mapagpipilian	Global add mode: instant or review. Default is instant; can be overridden by defaults.mode or item.mode instantreview Halimbawa: instant
`defaults`	object	Mapagpipilian	Default params for all items. Supports single add API params such as warranty/shtype/type/deviceType/beizhu/code/token/mode Halimbawa: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Mapagpipilian	Device item array. Each item requires udid and can override any defaults field. Provide at least one of items/udids/udids_text Halimbawa: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Mapagpipilian	Simplified UDID array. Uses defaults/global params for all devices Halimbawa: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Mapagpipilian	Text UDID list separated by comma, semicolon, whitespace, or new lines Halimbawa: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Mapagpipilian	Whether to continue after an item fails. Default true Halimbawa: true

Pagtugon

Parameter	Uri	Kailangan	Paglalarawan
`code`	number	Kailangan	Status code: 1=batch request processed Halimbawa: 1
`data.total`	number	Kailangan	Total requested devices Halimbawa: 2
`data.processed`	number	Kailangan	Actually processed item count Halimbawa: 2
`data.success`	number	Kailangan	Success count Halimbawa: 1
`data.failed`	number	Kailangan	Failure count Halimbawa: 1
`data.results`	array	Kailangan	Per-item results with index/udid/mode/success/code/msg/data/raw Halimbawa:

Pagtugon na Halimbawa

{

"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

}

]

}

Error

Error3 Binigyang - katuturan

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

Pagtugon sa Wika

Ang mga code na halimbawa sa ibaba ay awtomatikong gumagamit ng kasalukuyang site language mo.

Inirerekomendang Tagapangulo

X-Lang: fil

Suportadong mga Wika

zh, en, zh-TW, vi, ar, es, ru

Sinusuportahan din ang tinatanggap na-Language; ang X-Lang ang inuuna. ang mga hindi suportadong wika ay sumusunod sa site language fallback.

Mga Halimbawa ng Kodigo

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/batch" \
  -H "X-Lang: fil" \
  -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
  }'

Mga Noble

该接口复用 /api/adddevice 和 /api/addyydevice 的原有业务逻辑，逐条处理，逐条扣款/退款/复用证书
请求体必须是 JSON；单条设备参数会转换为表单参数后调用原接口逻辑
defaults 提供公共参数，items 中同名字段优先级更高
mode 支持 instant/review；也兼容 reservation/reserve/yy/addyydevice 作为 review
单次最多 50 条，接口本身限流 10 次/分钟

Subukin ito sa Console

Punan ang mga parameter sa ibaba at magpadala ng kahilingan upang masubukan. requests pumunta lamang sa API ng site na ito; ang URL ay naka-lock at hindi maaaring baguhin, at isama ang inyong kasalukuyang login cookie.

POSThttps://testypro.iwai.cc/api/adddevice/batchNakakandado sa lugar na ito

tokenstring

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

modestring

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

defaultsobject

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

itemsarray

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

udidsarray

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

udids_textstring

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

continue_on_errorboolean

Whether to continue after an item fails. Default true