返回首頁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，可被覆蓋
instantreview
範例: instant
defaults
object選填
批量預設參數，支援單設備接口參數，例如 warranty/shtype/type/deviceType/beizhu/code/token/mode
範例: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
items
array選填
設備陣列。每一項至少提供 udid，並可覆蓋 defaults 中任意欄位
範例: [{"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必填
逐條結果
範例:
回應示例
{
"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 Body 無效
請求體不是合法 JSON
0
需要 items 或 udids
未提供任何設備
0
項目過多，最多 50
單次批量最多 50 台

回應語言

透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。

建議請求標頭
X-Lang: zh-TW
支援的語言
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-TW" \
  -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
  • 單次最多 50 條，接口本身限流 10 次/分鐘

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

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

全域用戶 API Token。若 item 或 defaults 未提供 token，則使用該值

string

全域添加模式：instant=秒出，review=預約。預設 instant，可被覆蓋

object

批量預設參數，支援單設備接口參數，例如 warranty/shtype/type/deviceType/beizhu/code/token/mode

array

設備陣列。每一項至少提供 udid，並可覆蓋 defaults 中任意欄位

array

簡化 UDID 陣列，會按 defaults/global 參數批量添加

string

文本 UDID 列表，支援逗號、分號、空格、換行分隔

boolean

單條失敗後是否繼續處理後續設備，預設 true