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

Auth:API Key

Limite:10/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

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

Risposta

Parametro	Tipo	Obbligo	Descrizione
`code`	number	Obbligo	Status code: 1=batch request processed Esempio: 1
`data.total`	number	Obbligo	Total requested devices Esempio: 2
`data.processed`	number	Obbligo	Actually processed item count Esempio: 2
`data.success`	number	Obbligo	Success count Esempio: 1
`data.failed`	number	Obbligo	Failure count Esempio: 1
`data.results`	array	Obbligo	Per-item results with index/udid/mode/success/code/msg/data/raw Esempio:

Esempio di risposta

{

"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

}

]

}

Codici di errore

Codici di errore3 definito

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

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata

X-Lang: it

Lingue supportate

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

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

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

Note

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

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

POSThttps://testypro.iwai.cc/api/adddevice/batchBloccato a questo sito

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