GETPOST
v2.1.0stable

Thêm thiết bị (Đặt trước)

Đăng ký thiết bị ở chế độ đặt trước. mobileprovision có thể trống khi chưa được Apple phê duyệt

GET | POST/api/addyydevice
Xác thực:API Key
Giới hạn:30/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ị. Độ dài phải là 25 hoặc 40 ký tự
Ví dụ: 00008030-001234567890ABCD
warranty
stringTùy chọn
Loại bảo hành: 0/1/2/3/4/6. Khuyến nghị truyền rõ ràng
012346
Ví dụ: 1
shtype
stringTùy chọn
Bí danh của warranty. Chỉ dùng khi warranty để trống
012346
Ví dụ: 1
type
stringTùy chọn
Loại pool: 0=công cộng, 1=riêng. Mặc định là 0
01
Ví dụ: 0
deviceType
stringTùy chọn
Loại thiết bị: iphone hoặc ipad. Mặc định là iphone
iphoneipad
Ví dụ: iphone
beizhu
stringTùy chọn
Ghi chú, tối đa 40 ký tự
Ví dụ: 预约测试设备

Phản hồi

Tham sốLoạiBắt buộcMô tả
code
numberBắt buộc
Mã trạng thái: 1=thành công, 0=thất bại
Ví dụ: 1
msg
stringBắt buộc
Tin nhắn phản hồi
Ví dụ: 添加成功
time
numberBắt buộc
Mốc thời gian máy chủ (giây Unix)
Ví dụ: 1769675945
data
objectBắt buộc
Dữ liệu phản hồi
data.id
stringBắt buộc
Đơn đặt trước / ID chứng chỉ (thường là 5 ký tự chữ số)
Ví dụ: A1B2C
data.pool
numberBắt buộc
Pool: 0=công cộng, 1=riêng
Ví dụ: 0
data.addtime
numberBắt buộc
Thời gian thêm (Unix)
Ví dụ: 1706500000
data.mobileprovision
stringBắt buộc
mobileprovision được mã hóa Base64 (có thể trống khi chưa được phê duyệt)
Ví dụ: Base64EncodedString...
data.p12
stringBắt buộc
Chứng chỉ P12 được mã hóa Base64
Ví dụ: Base64EncodedString...
data.state
booleanBắt buộc
Trạng thái hiệu lực chứng chỉ (trả về trong một số trường hợp)
Ví dụ: true
ysucc
stringBắt buộc
Cờ thành công, trả về "Ysucc" khi thành công
Ví dụ: Ysucc
Ví dụ phản hồi
{
"code":1,
"msg":"Đặt lịch thành công",
"time":1769675945,
"data":
{
"id":"A1B2C",
"pool":0,
"addtime":1706500000,
"mobileprovision":"",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Mã lỗi

Mã lỗi4 được định nghĩa
0
Token không hợp lệ
Token không hợp lệ hoặc đã hết hạn
0
Định dạng UDID không hợp lệ
Độ dài UDID phải là 25 hoặc 40 ký tự
0
Số dư không đủ
Số dư không đủ

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/addyydevice" \
  -H "X-Lang: vi" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E9%A2%84%E7%BA%A6%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87"

Lưu ý

  • Gửi tham số qua Query hoặc x-www-form-urlencoded. JSON body không được phân tích
  • shtype là bí danh cũ của warranty, chỉ dùng khi warranty để trống
  • mobileprovision trống thường chỉ ra rằng đang chờ phê duyệt, kiểm tra trạng thái qua API danh sách thiết bị

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/addyydevice?token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E9%A2%84%E7%BA%A6%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87Đã 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ị. Độ dài phải là 25 hoặc 40 ký tự

string

Loại bảo hành: 0/1/2/3/4/6. Khuyến nghị truyền rõ ràng

string

Bí danh của warranty. Chỉ dùng khi warranty để trống

string

Loại pool: 0=công cộng, 1=riêng. Mặc định là 0

string

Loại thiết bị: iphone hoặc ipad. Mặc định là iphone

string

Ghi chú, tối đa 40 ký tự