POST

v2.2.0stable

Tambah Peranti Secara Pukal

Daftar berkelompok pelbagai UDID dengan tetapan lalai yang fleksibel dan penggantian bagi setiap item. Setiap item boleh menggunakan mod segera atau tempahan.

POST/api/adddevice/batch

Pengesahan:API Key

Had:10/minit

Parameter Permintaan

Semua parameter boleh dihantar melalui Kuiri atau Badan

Parameter	Jenis	Diperlukan	Penerangan
`token`	string	Pilihan	Token API pengguna global. Digunakan apabila item/default tidak menyediakan token Contoh: your_api_token_here
`mode`	string	Pilihan	Mod tambah global: segera atau semakan. Lalai adalah segera; boleh digantikan oleh defaults.mode atau item.mode instantreview Contoh: instant
`defaults`	object	Pilihan	Parameter lalai untuk semua item. Menyokong parameter API tambah tunggal seperti warranty/shtype/type/deviceType/beizhu/code/token/mode Contoh: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Pilihan	Array item peranti. Setiap item memerlukan UDID dan boleh menimpa sebarang medan lalai. Sediakan sekurang-kurangnya salah satu daripada items/udids/udids_text Contoh: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Pilihan	Array UDID yang dipermudahkan. Menggunakan lalai/param global untuk semua peranti Contoh: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Pilihan	Senarai UDID teks dipisahkan oleh koma, titik koma, ruang kosong, atau baris baru Contoh: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Pilihan	Sama ada untuk meneruskan selepas satu item gagal. Lalai benar Contoh: true

Respons

Parameter	Jenis	Diperlukan	Penerangan
`code`	number	Diperlukan	Kod status: 1=permintaan kumpulan diproses Contoh: 1
`data.total`	number	Diperlukan	Jumlah peranti yang diminta Contoh: 2
`data.processed`	number	Diperlukan	Sebenarnya bilangan item yang diproses Contoh: 2
`data.success`	number	Diperlukan	Bilangan kejayaan Contoh: 1
`data.failed`	number	Diperlukan	Bilangan kegagalan Contoh: 1
`data.results`	array	Diperlukan	Keputusan setiap item dengan indeks/UDID/mod/kejayaan/kod/msg/data/raw Contoh:

Contoh Respons

{

"code":1,

"msg":"Permintaan kumpulan 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

}

]

}

Kod Ralat

Kod Ralat3 ditakrifkan

0

Badan JSON tidak sah

Badan permintaan bukan JSON yang sah

0

items atau udids diperlukan

Tiada peranti disediakan

0

Terlalu banyak item, maksimum ialah 50

Maksimum 50 peranti setiap kumpulan

X-Lang: en

zh, en, zh-TW, vi, ar

Contoh Kod

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

Nota

Titik akhir ini menggunakan semula logik perniagaan /API/adddevice dan /API/addyydevice dan memproses item satu persatu
Badan permintaan mesti dalam JSON. Parameter per item ditukar kepada parameter borang secara dalaman
nilai lalai menyediakan parameter berkongsi; medan item mempunyai keutamaan lebih tinggi
mod menyokong segera/ulasan; reservation/reserve/yy/addyydevice adalah alias untuk ulasan
Maksimum 50 item setiap permintaan, had kadar 10 permintaan/minit

Cuba di Konsol

Isikan parameter di bawah dan hantar permintaan untuk menguji. Permintaan hanya dihantar ke API laman ini; URL dikunci dan tidak boleh diubah, dan kuki log masuk semasa anda disertakan.

POSThttps://testypro.iwai.cc/api/adddevice/batchDikunci ke laman ini

tokenstring

Token API pengguna global. Digunakan apabila item/default tidak menyediakan token

modestring

Mod tambah global: segera atau semakan. Lalai adalah segera; boleh digantikan oleh defaults.mode atau item.mode

defaultsobject

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

itemsarray

Array item peranti. Setiap item memerlukan UDID dan boleh menimpa sebarang medan lalai. Sediakan sekurang-kurangnya salah satu daripada items/udids/udids_text

udidsarray

Array UDID yang dipermudahkan. Menggunakan lalai/param global untuk semua peranti

udids_textstring

Senarai UDID teks dipisahkan oleh koma, titik koma, ruang kosong, atau baris baru

continue_on_errorboolean

Sama ada untuk meneruskan selepas satu item gagal. Lalai benar