GETPOST
v2.2.0stable

Thêm thiết bị V2

API thêm một thiết bị thống nhất. Chuyển giữa chế độ tức thì và đặt trước bằng một tham số, vẫn giữ API cũ.

GET | POST/api/adddevice/v2
Xác thực:API Key
Giới hạn:60/phút

Tham số yêu cầu

Tất cả tham số có thể truyền qua Query hoặc Body

Tham sốLoạiBắt buộcMô tả
token
stringBắt buộc
Token API người dùng
Ví dụ: your_api_token_here
udid
stringBắt buộc
UDID thiết bị (phải là 25 hoặc 40 ký tự)
Ví dụ: 00008030-001234567890ABCD
mode
stringTùy chọn
Chế độ thêm: instant hoặc review. Mặc định instant
instantreview
Ví dụ: instant
add_mode
stringTùy chọn
Bí danh của mode, ưu tiên cao hơn mode
instantreview
Ví dụ: review
force
booleanTùy chọn
Cờ thêm bắt buộc. true/1/yes/y/on bỏ qua kiểm tra thiết bị tồn tại và thời gian bắt buộc
Ví dụ: true
warranty
stringTùy chọn
Loại bảo hành: 0/1/2/3/4/6. Chế độ review không hỗ trợ 4/6
012346
Ví dụ: 1
shtype
stringTùy chọn
Bí danh cũ của warranty
012346
Ví dụ: 1
type
stringTùy chọn
Loại pool: 0 công cộng, 1 riêng
01
Ví dụ: 0
deviceType
stringTùy chọn
Loại thiết bị: iphone hoặc ipad
iphoneipad
Ví dụ: iphone
beizhu
stringTùy chọn
Ghi chú
Ví dụ: 测试设备
code
stringTùy chọn
Mã kích hoạt (tùy chọn)
Ví dụ: ABC123XYZ

Phản hồi

Tham sốLoạiBắt buộcMô tả
code
numberBắt buộc
Mã trạng thái
Ví dụ: 1
msg
stringBắt buộc
Thông báo phản hồi
Ví dụ: 添加成功
data.id
stringBắt buộc
ID chứng chỉ / đặt trước
Ví dụ: AB12CD34
data.mobileprovision
stringBắt buộc
mobileprovision Base64, có thể rỗng khi đang duyệt
Ví dụ: Base64EncodedString...
data.p12
stringBắt buộc
Chứng chỉ P12 Base64
Ví dụ: Base64EncodedString...
Ví dụ phản hồi
{
"code":1,
"msg":"Thêm thiết bị thành công",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Mã lỗi

Mã lỗi3 được định nghĩa
0
Token không hợp lệ
Token không hợp lệ hoặc hết hạn
0
UDID không hợp lệ
UDID phải dài 25 hoặc 40 ký tự
0
Trong thời gian bắt buộc
Truyền force=true để thử thêm mới

Ngôn ngữ phản hồi

Tùy chỉnh ngôn ngữ phản hồi API bằng header X-Lang. Ví dụ mã bên dưới tự động sử dụng ngôn ngữ trang hiện tại của bạn.

Header đề xuất
X-Lang: vi
Ngôn ngữ được hỗ trợ
zh, en, zh-TW, vi, ar

Bạn cũng có thể dùng Accept-Language; X-Lang có ưu tiên cao hơn. Ngôn ngữ không được hỗ trợ sẽ chuyển sang tiếng Anh.

Ví dụ mã

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/v2" \
  -H "X-Lang: vi" \
  -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"
  }'

Lưu ý

  • API cũ /api/adddevice và /api/addyydevice vẫn được giữ và tương thích
  • mode=instant dùng logic thêm tức thì; mode=review dùng logic đặt trước
  • Hỗ trợ Query, form và JSON body; khuyến nghị JSON cho V2
  • force=true chỉ bỏ qua kiểm tra cục bộ, Apple vẫn có thể từ chối trùng lặp
  • Chế độ review vẫn theo giới hạn của API đặt trước

Thử trong Console

Điền các tham số bên dưới rồi gửi yêu cầu để kiểm tra. Yêu cầu chỉ gửi đến API của trang này; địa chỉ đã bị khóa và không thể thay đổi, đồng thời kèm theo Cookie đăng nhập hiện tại của bạn.

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Đã khóa vào trang này
stringBắt buộc

Token API người dùng

stringBắt buộc

UDID thiết bị (phải là 25 hoặc 40 ký tự)

string

Chế độ thêm: instant hoặc review. Mặc định instant

string

Bí danh của mode, ưu tiên cao hơn mode

boolean

Cờ thêm bắt buộc. true/1/yes/y/on bỏ qua kiểm tra thiết bị tồn tại và thời gian bắt buộc

string

Loại bảo hành: 0/1/2/3/4/6. Chế độ review không hỗ trợ 4/6

string

Bí danh cũ của warranty

string

Loại pool: 0 công cộng, 1 riêng

string

Loại thiết bị: iphone hoặc ipad

string

Ghi chú

string

Mã kích hoạt (tùy chọn)