GETPOST
v2.2.0stable

เพิ่มอุปกรณ์ V2

API การเพิ่มอุปกรณ์แบบรวมอันเดียว สลับระหว่างโหมดทันทีและโหมดจองด้วยพารามิเตอร์เดียวในขณะที่ยังคงสามารถใช้ API แบบเก่าได้

GET | POST/api/adddevice/v2
การยืนยันตัวตน:API Key
ขีดจำกัด:60/นาที

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

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

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
token
stringจำเป็น
โทเค็น API ของผู้ใช้
ตัวอย่าง: your_api_token_here
udid
stringจำเป็น
UDID ของอุปกรณ์ (ต้องมีความยาว 25 หรือ 40 ตัวอักษร)
ตัวอย่าง: 00008030-001234567890ABCD
mode
stringตัวเลือก
โหมดการเพิ่ม: ทันทีหรือทบทวน ค่าเริ่มต้นคือทันที
instantreview
ตัวอย่าง: instant
add_mode
stringตัวเลือก
ชื่อแทนของโหมด มีลำดับความสำคัญเหนือโหมด
instantreview
ตัวอย่าง: review
force
booleanตัวเลือก
บังคับเพิ่มแฟล็ก true/1/yes/y/on ข้ามการตรวจสอบ force-period และการตรวจสอบอุปกรณ์ที่มีอยู่
ตัวอย่าง: true
warranty
stringตัวเลือก
ประเภทการรับประกัน: 0/1/2/3/4/6. โหมดตรวจสอบไม่รองรับ 4/6
012346
ตัวอย่าง: 1
shtype
stringตัวเลือก
ชื่อย่อแบบเดิมของการรับประกัน ใช้เฉพาะเมื่อการรับประกันว่าง
012346
ตัวอย่าง: 1
type
stringตัวเลือก
ประเภทพูล: 0=สาธารณะ, 1=ส่วนตัว ค่าเริ่มต้นตามตรรกะ API แบบเก่า
01
ตัวอย่าง: 0
deviceType
stringตัวเลือก
ประเภทอุปกรณ์: iphone หรือ ipad ค่าเริ่มต้นคือ iphone
iphoneipad
ตัวอย่าง: iphone
beizhu
stringตัวเลือก
หมายเหตุ
ตัวอย่าง: 测试设备
code
stringตัวเลือก
รหัสเปิดใช้งาน (ไม่บังคับ)
ตัวอย่าง: ABC123XYZ

การตอบสนอง

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
code
numberจำเป็น
รหัสสถานะ: 1=สำเร็จ, 0=ล้มเหลว
ตัวอย่าง: 1
msg
stringจำเป็น
ข้อความตอบกลับ
ตัวอย่าง: 添加成功
data.id
stringจำเป็น
รหัสใบรับรอง / รหัสการจอง
ตัวอย่าง: AB12CD34
data.mobileprovision
stringจำเป็น
Base64 mobileprovision อาจว่างในขณะที่รอการตรวจสอบ
ตัวอย่าง: Base64EncodedString...
data.p12
stringจำเป็น
Base64 ใบรับรอง P12
ตัวอย่าง: Base64EncodedString...
ตัวอย่างการตอบสนอง
{
"code":1,
"msg":"เพิ่มอุปกรณ์สำเร็จแล้ว",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

รหัสข้อผิดพลาด

รหัสข้อผิดพลาด3 กำหนดไว้
0
โทเค็นไม่ถูกต้อง
โทเค็นไม่ถูกต้องหรือหมดอายุแล้ว
0
รูปแบบ UDID ไม่ถูกต้อง
ความยาว UDID ต้องเป็น 25 หรือ 40
0
อยู่ในช่วงเวลาบังคับเพิ่มอุปกรณ์
ส่ง force=true เพื่อบังคับให้ลองเพิ่มใหม่

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/v2" \
  -H "X-Lang: en" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_api_token_here",
    "udid": "00008030-001234567890ABCD",
    "mode": "instant",
    "add_mode": "review",
    "force": true,
    "warranty": "1",
    "shtype": "1",
    "type": "0",
    "deviceType": "iphone",
    "beizhu": "测试设备",
    "code": "ABC123XYZ"
  }'

หมายเหตุ

  • Legacy /API/adddevice และ /API/addyydevice ยังคงใช้งานได้และเข้ากันได้
  • โหมด=instant ใช้ซ้ำตรรกะการเพิ่มแบบทันที; โหมด=review ใช้ซ้ำตรรกะการเพิ่มการจอง/ตรวจสอบ
  • รองรับการ Query, x-www-form-urlencoded, และ JSON body; แนะนำให้ใช้ JSON body สำหรับ V2
  • force=true จะข้ามเฉพาะการตรวจสอบ force-period/short-circuit ท้องถิ่นเท่านั้น Apple ยังอาจปฏิเสธรายการซ้ำได้
  • โหมดรีวิวยังคงปฏิบัติตามข้อจำกัดของ API การจอง เช่น การรับประกัน=4/6 ไม่สามารถรองรับ

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

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

https://testypro.iwai.cc/api/adddevice/v2?token=your_api_token_here&udid=00008030-001234567890ABCD&mode=instant&add_mode=review&force=true&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZถูกล็อกกับเว็บไซต์นี้
stringจำเป็น

โทเค็น API ของผู้ใช้

stringจำเป็น

UDID ของอุปกรณ์ (ต้องมีความยาว 25 หรือ 40 ตัวอักษร)

string

โหมดการเพิ่ม: ทันทีหรือทบทวน ค่าเริ่มต้นคือทันที

string

ชื่อแทนของโหมด มีลำดับความสำคัญเหนือโหมด

boolean

บังคับเพิ่มแฟล็ก true/1/yes/y/on ข้ามการตรวจสอบ force-period และการตรวจสอบอุปกรณ์ที่มีอยู่

string

ประเภทการรับประกัน: 0/1/2/3/4/6. โหมดตรวจสอบไม่รองรับ 4/6

string

ชื่อย่อแบบเดิมของการรับประกัน ใช้เฉพาะเมื่อการรับประกันว่าง

string

ประเภทพูล: 0=สาธารณะ, 1=ส่วนตัว ค่าเริ่มต้นตามตรรกะ API แบบเก่า

string

ประเภทอุปกรณ์: iphone หรือ ipad ค่าเริ่มต้นคือ iphone

string

หมายเหตุ

string

รหัสเปิดใช้งาน (ไม่บังคับ)