POST

v2.2.0stable

Tambah Perangkat Massal

Daftar massal beberapa UDID dengan default fleksibel dan pengaturan per item. Setiap item dapat menggunakan mode instan atau reservasi.

POST/api/adddevice/batch

Otentikasi:API Key

Batas:10/menit

Parameter Permintaan

Semua parameter dapat dikirim melalui Query atau Body

Parameter	Tipe	Wajib	Deskripsi
`token`	string	Opsional	Token API pengguna global. Digunakan ketika item/defaults tidak menyediakan token Contoh: your_api_token_here
`mode`	string	Opsional	Mode penambahan global: instan atau tinjau. Default adalah instan; dapat ditimpa oleh defaults.mode atau item.mode instantreview Contoh: instant
`defaults`	object	Opsional	Parameter default untuk semua item. Mendukung parameter API tambah tunggal seperti warranty/shtype/type/deviceType/beizhu/code/token/mode Contoh: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Opsional	Array item perangkat. Setiap item memerlukan UDID dan dapat menimpa bidang default apapun. Sediakan setidaknya salah satu dari items/udids/udids_text Contoh: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Opsional	Array UDID yang disederhanakan. Menggunakan default/params global untuk semua perangkat Contoh: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Opsional	Daftar UDID dalam teks yang dipisahkan oleh koma, titik koma, spasi, atau baris baru Contoh: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Opsional	Apakah melanjutkan setelah satu item gagal. Default true Contoh: true

Respon

Parameter	Tipe	Wajib	Deskripsi
`code`	number	Wajib	Kode status: 1=request batch diproses Contoh: 1
`data.total`	number	Wajib	Total perangkat yang diminta Contoh: 2
`data.processed`	number	Wajib	Sebenarnya jumlah item yang diproses Contoh: 2
`data.success`	number	Wajib	Jumlah sukses Contoh: 1
`data.failed`	number	Wajib	Jumlah gagal Contoh: 1
`data.results`	array	Wajib	Hasil per item dengan indeks/UDID/mode/sukses/kode/pesan/data/mentah Contoh:

Contoh Respon

{

"code":1,

"msg":"Permintaan batch diproses",

"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

}

]

}

Kode Kesalahan

Kode Kesalahan3 didefinisikan

0

Body JSON tidak valid

Body permintaan bukan JSON yang valid

0

items atau udids diperlukan

Tidak ada perangkat yang diberikan

0

Terlalu banyak item, maksimum adalah 50

Maksimum 50 perangkat per batch

X-Lang: en

zh, en, zh-TW, vi, ar

Contoh Kode

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
  }'

Catatan

Endpoint ini menggunakan kembali logika bisnis /API/adddevice dan /API/addyydevice dan memproses item satu per satu
Body permintaan harus berupa JSON. Parameter per-item dikonversi menjadi parameter form secara internal
Default menyediakan parameter bersama; field item memiliki prioritas lebih tinggi
Mode mendukung instant/review; reservation/reserve/yy/addyydevice adalah alias untuk review
Maksimal 50 item per permintaan, dibatasi 10 permintaan/menit

Coba di Konsol

Isi parameter di bawah ini dan kirim permintaan untuk menguji. Permintaan hanya dikirim ke API situs ini; URL terkunci dan tidak dapat diubah, dan cookie login Anda saat ini disertakan.

POSThttps://testypro.iwai.cc/api/adddevice/batchTerkunci ke situs ini

tokenstring

Token API pengguna global. Digunakan ketika item/defaults tidak menyediakan token

modestring

Mode penambahan global: instan atau tinjau. Default adalah instan; dapat ditimpa oleh defaults.mode atau item.mode

defaultsobject

Parameter default untuk semua item. Mendukung parameter API tambah tunggal seperti warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

Array item perangkat. Setiap item memerlukan UDID dan dapat menimpa bidang default apapun. Sediakan setidaknya salah satu dari items/udids/udids_text

udidsarray

Array UDID yang disederhanakan. Menggunakan default/params global untuk semua perangkat

udids_textstring

Daftar UDID dalam teks yang dipisahkan oleh koma, titik koma, spasi, atau baris baru

continue_on_errorboolean

Apakah melanjutkan setelah satu item gagal. Default true