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	Опционально	Глобальный режим добавления: мгновенно или проверка. По умолчанию мгновенно; может быть переопределен defaults.mode или item.mode instantreview Пример: instant
`defaults`	object	Опционально	Параметры по умолчанию для всех элементов. Поддерживает отдельные параметры API добавления, такие как warranty/shtype/type/deviceType/beizhu/code/token/mode Пример: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Опционально	Массив элементов устройства. Каждый элемент требует UDID и может переопределять любые поля по умолчанию. Укажите как минимум один из items/udids/udids_text Пример: [{"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	Обязательный	Результаты по каждому элементу с индексом/UDID/режим/успех/код/сообщение/данные/сырой вид Пример:

Пример ответа

{

"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

Требуются элементы или udids

Устройство не предоставлено

0

Слишком много элементов, максимум 50

Максимум 50 устройств за пакет

Язык ответа

Настройте язык ответа API с помощью заголовка X-Lang. Примеры кода ниже автоматически используют текущий язык сайта.

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

X-Lang: ru

Поддерживаемые языки

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

Также поддерживается 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: ru" \
  -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. Параметры для каждого элемента внутренне преобразуются в параметры формы
значения по умолчанию предоставляют общие параметры; поля элемента имеют более высокий приоритет
режим поддерживает instant/review; reservation/reserve/yy/addyydevice являются алиасами для review
Максимум 50 элементов за запрос, ограничение скорости до 10 запросов в минуту

Попробуйте в Консоли

Заполните параметры ниже и отправьте запрос для тестирования. Запросы отправляются только на API этого сайта; URL зафиксирован и не может быть изменен, а текущий файл cookie для входа включен.

POSThttps://testypro.iwai.cc/api/adddevice/batchЗаблокировано для этого сайта

tokenstring

Глобальный API-токен пользователя. Используется, когда item/defaults не предоставляют токен

modestring

Глобальный режим добавления: мгновенно или проверка. По умолчанию мгновенно; может быть переопределен defaults.mode или item.mode

defaultsobject

Параметры по умолчанию для всех элементов. Поддерживает отдельные параметры API добавления, такие как warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

Массив элементов устройства. Каждый элемент требует UDID и может переопределять любые поля по умолчанию. Укажите как минимум один из items/udids/udids_text

udidsarray

Упрощенный массив UDID. Использует значения по умолчанию/глобальные параметры для всех устройств

udids_textstring

Список UDID в виде текста, разделенный запятой, точкой с запятой, пробелом или новой строкой

continue_on_errorboolean

Продолжать ли выполнение после ошибки элемента. По умолчанию true