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

Параметри запиту

Всі параметри можуть бути передані через Query або тіло

Параметр	Тип	Потрібні	Опис
`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

Мова відповіді

Налаштуйте мову відповіді API з заголовком X-Lang. Приклади коду нижче автоматично використовуйте мову поточного сайту.

Рекомендований заголовок

X-Lang: uk

Підтримувані мови

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: uk" \
  -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-адреса заблокована і не може бути змінена, і ваш поточний логін cookie включено.

POSThttps://testypro.iwai.cc/api/adddevice/batchЗаблоковано на цей сайт

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