返回首页API 文档
语言: 简体中文
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
返回文档列表
POST
v2.2.0stable

批量添加设备

批量提交多个 UDID，支持全局默认参数和单条覆盖参数。每条设备可单独选择秒出或预约模式。

POST/api/adddevice/batch
认证:API Key
限流:10/分钟

请求参数

所有请求参数需通过 Query 或 Body 传递

参数名类型必填说明
token
string可选
全局用户 API Token。若 item 或 defaults 未提供 token，则使用该值
示例: your_api_token_here
mode
string可选
全局添加模式：instant=秒出，review=预约。默认 instant，可被 defaults.mode 或 item.mode 覆盖
instantreview
示例: instant
defaults
object可选
批量默认参数，支持单设备接口的参数，例如 warranty/shtype/type/deviceType/beizhu/code/token/mode
示例: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
items
array可选
设备数组。每一项至少提供 udid，并可覆盖 defaults 中任意字段。items/udids/udids_text 至少传一种
示例: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
udids
array可选
简化 UDID 数组，会按 defaults/global 参数批量添加
示例: ["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必填
逐条结果，每条包含 index/udid/mode/success/code/msg/data/raw
示例:
响应示例
{
"code":1,
"msg":"batch 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
请求体不是合法 JSON
0
items or udids is required
未提供任何设备
0
too many items, maximum is 50
单次批量最多 50 台

响应语言

通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。

推荐请求头
X-Lang: zh
支持的语言
zh, en, zh-TW, vi, ar

也可以使用 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: zh" \
  -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 次/分钟

在控制台试一试

填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态

POSThttps://testypro.iwai.cc/api/adddevice/batch已锁定本站
string

全局用户 API Token。若 item 或 defaults 未提供 token，则使用该值

string

全局添加模式：instant=秒出，review=预约。默认 instant，可被 defaults.mode 或 item.mode 覆盖

object

批量默认参数，支持单设备接口的参数，例如 warranty/shtype/type/deviceType/beizhu/code/token/mode

array

设备数组。每一项至少提供 udid，并可覆盖 defaults 中任意字段。items/udids/udids_text 至少传一种

array

简化 UDID 数组，会按 defaults/global 参数批量添加

string

文本 UDID 列表，支持逗号、分号、空格、换行分隔

boolean

单条失败后是否继续处理后续设备，默认 true