POST

v2.2.0stable

เพิ่มอุปกรณ์เป็นชุด

ลงทะเบียน UDID หลายรายการเป็นชุดด้วยค่าตั้งต้นที่ยืดหยุ่นและการแทนที่ต่อรายการ แต่ละรายการสามารถใช้โหมดทันทีหรือโหมดจอง

POST/api/adddevice/batch

การยืนยันตัวตน:API Key

ขีดจำกัด:10/นาที

พารามิเตอร์คำขอ

พารามิเตอร์ทั้งหมดสามารถส่งผ่าน Query หรือ Body

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
`token`	string	ตัวเลือก	โทเค็น API ผู้ใช้ทั่วโลก ใช้เมื่อ item/defaults ไม่ได้ให้โทเค็น ตัวอย่าง: your_api_token_here
`mode`	string	ตัวเลือก	โหมดเพิ่มทั่วโลก: ทันทีหรือทบทวน ค่าเริ่มต้นคือทันที; สามารถถูกแทนที่โดย defaults.mode หรือ item.mode instantreview ตัวอย่าง: instant
`defaults`	object	ตัวเลือก	พารามิเตอร์เริ่มต้นสำหรับทุกไอเท็ม รองรับพารามิเตอร์ API การเพิ่มเดียว เช่น warranty/shtype/type/deviceType/beizhu/code/token/mode ตัวอย่าง: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	ตัวเลือก	อาร์เรย์รายการอุปกรณ์ แต่ละรายการต้องมี UDID และสามารถแทนที่ฟิลด์เริ่มต้นใดก็ได้ ต้องให้รายการอย่างน้อยหนึ่งรายการจาก 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	จำเป็น	ผลลัพธ์ต่อรายการพร้อมดัชนี/UDID/โหมด/สำเร็จ/รหัส/ข้อความ/ข้อมูล/ดิบ ตัวอย่าง:

ตัวอย่างการตอบสนอง

{

"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 ไม่ถูกต้อง

ร่างคำขอไม่ใช่ JSON ที่ถูกต้อง

0

ต้องระบุ items หรือ udids

ไม่มีอุปกรณ์ที่ให้มา

0

มีรายการมากเกินไป สูงสุดคือ 50

สูงสุด 50 อุปกรณ์ต่อชุด

X-Lang: en

zh, en, zh-TW, vi, ar

ตัวอย่างโค้ด

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

หมายเหตุ

เอ็นด์พอยต์นี้ใช้ซ้ำ /API/adddevice และ /API/addyydevice ซึ่งเป็นตรรกะทางธุรกิจ และประมวลผลรายการทีละรายการ
ร่างคำขอต้องเป็น JSON; พารามิเตอร์ต่อรายการจะถูกแปลงเป็นพารามิเตอร์แบบฟอร์มภายใน
ค่าเริ่มต้นให้พารามิเตอร์ที่ใช้ร่วมกัน; ฟิลด์ของรายการมีลำดับความสำคัญสูงกว่า
โหมดรองรับ instant/review; reservation/reserve/yy/addyydevice เป็นชื่อเรียกแทนสำหรับ review
สูงสุด 50 รายการต่อคำขอ จำกัดอัตรา 10 คำขอต่อนาที

ลองใช้ในคอนโซล

กรอกพารามิเตอร์ด้านล่างและส่งคำขอเพื่อทดสอบ คำขอจะส่งไปยัง API ของเว็บไซต์นี้เท่านั้น URL ถูกล็อกและไม่สามารถเปลี่ยนแปลงได้ และคุกกี้การล็อกอินปัจจุบันของคุณถูกแนบมา

POSThttps://testypro.iwai.cc/api/adddevice/batchถูกล็อกกับเว็บไซต์นี้

tokenstring

โทเค็น API ผู้ใช้ทั่วโลก ใช้เมื่อ item/defaults ไม่ได้ให้โทเค็น

modestring

โหมดเพิ่มทั่วโลก: ทันทีหรือทบทวน ค่าเริ่มต้นคือทันที; สามารถถูกแทนที่โดย defaults.mode หรือ item.mode

defaultsobject

พารามิเตอร์เริ่มต้นสำหรับทุกไอเท็ม รองรับพารามิเตอร์ API การเพิ่มเดียว เช่น warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

อาร์เรย์รายการอุปกรณ์ แต่ละรายการต้องมี UDID และสามารถแทนที่ฟิลด์เริ่มต้นใดก็ได้ ต้องให้รายการอย่างน้อยหนึ่งรายการจาก items/udids/udids_text

udidsarray

อาร์เรย์ UDID แบบง่าย ใช้พารามิเตอร์ defaults/global สำหรับอุปกรณ์ทั้งหมด

udids_textstring

รายการ UDID แบบข้อความ คั่นด้วยเครื่องหมายจุลภาค จุดและลูกน้ำ, เว้นวรรค หรือบรรทัดใหม่

continue_on_errorboolean

ว่าจะดำเนินการต่อหลังจากที่รายการใดล้มเหลวหรือไม่ ค่าเริ่มต้นคือ true