POST

v2.2.0stable

Adicionar Dispositivos em Lote

Registrar múltiplos UDIDs em lote com padrões flexíveis e substituições por item. Cada item pode usar modo instantâneo ou de reserva.

POST/api/adddevice/batch

Autenticação:API Key

Limite:10/minuto

Parâmetros da Requisição

Todos os parâmetros podem ser passados via Query ou Body

Parâmetro	Tipo	Obrigatório	Descrição
`token`	string	Opcional	Token de API de usuário global. Usado quando item/defaults não fornece token Exemplo: your_api_token_here
`mode`	string	Opcional	Modo de adição global: instantâneo ou revisão. O padrão é instantâneo; pode ser substituído por defaults.mode ou item.mode instantreview Exemplo: instant
`defaults`	object	Opcional	Parâmetros padrão para todos os itens. Suporta parâmetros de API de adição única, como warranty/shtype/type/deviceType/beizhu/code/token/mode Exemplo: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Opcional	Array de itens do dispositivo. Cada item requer UDID e pode substituir qualquer campo padrão. Forneça pelo menos um dos itens/udids/udids_text Exemplo: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Opcional	Array de UDID simplificado. Usa parâmetros padrão/globais para todos os dispositivos Exemplo: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Opcional	Lista de UDIDs em texto separada por vírgula, ponto e vírgula, espaço em branco ou novas linhas Exemplo: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Opcional	Se deve continuar após a falha de um item. Padrão verdadeiro Exemplo: true

Resposta

Parâmetro	Tipo	Obrigatório	Descrição
`code`	number	Obrigatório	Código de status: 1=pacote de solicitação processado Exemplo: 1
`data.total`	number	Obrigatório	Total de dispositivos solicitados Exemplo: 2
`data.processed`	number	Obrigatório	Contagem de itens realmente processados Exemplo: 2
`data.success`	number	Obrigatório	Contagem de sucessos Exemplo: 1
`data.failed`	number	Obrigatório	Contagem de falhas Exemplo: 1
`data.results`	array	Obrigatório	Resultados por item com índice/UDID/modo/sucesso/código/mensagem/dados/bruto Exemplo:

Exemplo de Resposta

{

"code":1,

"msg":"Requisição em lote processada",

"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 Erro

Códigos de Erro3 definido

0

Corpo JSON inválido

O corpo da requisição não é um JSON válido

0

items ou udids são obrigatórios

Nenhum dispositivo fornecido

0

Muitos itens, o máximo é 50

Máximo de 50 dispositivos por lote

X-Lang: en

zh, en, zh-TW, vi, ar

Exemplos 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 a lógica de negócios de /API/adddevice e /API/addyydevice e processa os itens um por um
O corpo da requisição deve ser JSON. Os parâmetros por item são convertidos internamente em parâmetros de formulário
os padrões fornecem parâmetros compartilhados; os campos do item têm prioridade maior
o modo suporta instantâneo/revisão; reservation/reserve/yy/addyydevice são aliases para revisão
Máximo de 50 itens por requisição, limitados a 10 requisições/minuto

Tente no Console

Preencha os parâmetros abaixo e envie uma solicitação para testar. As solicitações vão apenas para a API deste site; a URL está bloqueada e não pode ser alterada, e seu cookie de login atual é incluído.

POSThttps://testypro.iwai.cc/api/adddevice/batchBloqueado para este site

tokenstring

Token de API de usuário global. Usado quando item/defaults não fornece token

modestring

Modo de adição global: instantâneo ou revisão. O padrão é instantâneo; pode ser substituído por defaults.mode ou item.mode

defaultsobject

Parâmetros padrão para todos os itens. Suporta parâmetros de API de adição única, como warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

Array de itens do dispositivo. Cada item requer UDID e pode substituir qualquer campo padrão. Forneça pelo menos um dos itens/udids/udids_text

udidsarray

Array de UDID simplificado. Usa parâmetros padrão/globais para todos os dispositivos

udids_textstring

Lista de UDIDs em texto separada por vírgula, ponto e vírgula, espaço em branco ou novas linhas

continue_on_errorboolean

Se deve continuar após a falha de um item. Padrão verdadeiro