POST

v2.2.0stable

Añadir Dispositivos por Lotes

Registrar en lote múltiples UDIDs con configuraciones predeterminadas flexibles y sobreescrituras por ítem. Cada ítem puede usar modo instantáneo o de reserva.

POST/api/adddevice/batch

Autenticación:API Key

Límite:10/minuto

Parámetros de solicitud

Todos los parámetros se pueden pasar vía Consulta o Cuerpo

Parámetro	Tipo	Requerido	Descripción
`token`	string	Opcional	Token de API global de usuario. Se utiliza cuando item/defaults no proporciona token Ejemplo: your_api_token_here
`mode`	string	Opcional	Modo de adición global: instantáneo o revisión. El predeterminado es instantáneo; puede ser sobrescrito por defaults.mode o item.mode instantreview Ejemplo: instant
`defaults`	object	Opcional	Parámetros predeterminados para todos los elementos. Soporta parámetros de API de adición única como warranty/shtype/type/deviceType/beizhu/code/token/mode Ejemplo: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Opcional	Array de elementos del dispositivo. Cada elemento requiere UDID y puede sobrescribir cualquier campo por defecto. Proporcione al menos uno de items/udids/udids_text Ejemplo: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Opcional	Array de UDID simplificado. Usa los parámetros por defecto/globales para todos los dispositivos Ejemplo: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Opcional	Lista de UDID en texto separada por comas, puntos y comas, espacios en blanco o saltos de línea Ejemplo: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Opcional	Indica si continuar después de que falle un elemento. Por defecto es true Ejemplo: true

Respuesta

Parámetro	Tipo	Requerido	Descripción
`code`	number	Requerido	Código de estado: 1=solicitud en lote procesada Ejemplo: 1
`data.total`	number	Requerido	Total de dispositivos solicitados Ejemplo: 2
`data.processed`	number	Requerido	Cantidad de elementos procesados Ejemplo: 2
`data.success`	number	Requerido	Cantidad de éxitos Ejemplo: 1
`data.failed`	number	Requerido	Cantidad de fallos Ejemplo: 1
`data.results`	array	Requerido	Resultados por elemento con índice/UDID/modo/éxito/código/mensaje/datos/crudo Ejemplo:

Ejemplo de respuesta

{

"code":1,

"msg":"Solicitud por lote procesada",

"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

}

]

}

Códigos de error

Códigos de error3 definido

0

Cuerpo JSON no válido

El cuerpo de la solicitud no es JSON válido

0

Se requieren elementos o udids

No se proporcionó dispositivo

0

Demasiados elementos, el máximo es 50

Máximo 50 dispositivos por lote

X-Lang: en

zh, en, zh-TW, vi, ar

Ejemplos de código

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

Notas

Este endpoint reutiliza la lógica de negocio de /API/adddevice y /API/addyydevice y procesa los elementos uno por uno
El cuerpo de la solicitud debe ser JSON. Los parámetros por elemento se convierten en parámetros de formulario internamente
Los valores predeterminados proporcionan parámetros compartidos; los campos de los elementos tienen mayor prioridad
El modo admite instantáneo/revisión; reservation/reserve/yy/addyydevice son alias de revisión
Máximo 50 elementos por solicitud, limitado a 10 solicitudes/minuto

Pruébalo en la Consola

Complete los parámetros a continuación y envíe una solicitud para probar. Las solicitudes solo van a la API de este sitio; la URL está bloqueada y no se puede cambiar, y se incluye su cookie de inicio de sesión actual.

POSThttps://testypro.iwai.cc/api/adddevice/batchBloqueado a este sitio

tokenstring

Token de API global de usuario. Se utiliza cuando item/defaults no proporciona token

modestring

Modo de adición global: instantáneo o revisión. El predeterminado es instantáneo; puede ser sobrescrito por defaults.mode o item.mode

defaultsobject

Parámetros predeterminados para todos los elementos. Soporta parámetros de API de adición única como warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

Array de elementos del dispositivo. Cada elemento requiere UDID y puede sobrescribir cualquier campo por defecto. Proporcione al menos uno de items/udids/udids_text

udidsarray

Array de UDID simplificado. Usa los parámetros por defecto/globales para todos los dispositivos

udids_textstring

Lista de UDID en texto separada por comas, puntos y comas, espacios en blanco o saltos de línea

continue_on_errorboolean

Indica si continuar después de que falle un elemento. Por defecto es true