GETPOST
v2.2.0stable

Tambah Perangkat V2

API penambahan perangkat tunggal yang terintegrasi. Beralih antara mode instan dan mode reservasi dengan satu parameter sambil tetap menjaga API lama tersedia.

GET | POST/api/adddevice/v2
Otentikasi:API Key
Batas:60/menit

Parameter Permintaan

Semua parameter dapat dikirim melalui Query atau Body

ParameterTipeWajibDeskripsi
token
stringWajib
Token API pengguna
Contoh: your_api_token_here
udid
stringWajib
UDID Perangkat (harus 25 atau 40 karakter)
Contoh: 00008030-001234567890ABCD
mode
stringOpsional
Mode penambahan: instan atau tinjau. Default adalah instan
instantreview
Contoh: instant
add_mode
stringOpsional
Alias dari mode. Memiliki prioritas dibanding mode
instantreview
Contoh: review
force
booleanOpsional
Tambahkan paksa flag. true/1/yes/y/on melewati pemeriksaan periode paksa dan pemeriksaan sirkuit pendek perangkat yang ada
Contoh: true
warranty
stringOpsional
Jenis garansi: 0/1/2/3/4/6. mode tinjau tidak mendukung 4/6
012346
Contoh: 1
shtype
stringOpsional
Alias lama dari garansi, digunakan hanya ketika garansi kosong
012346
Contoh: 1
type
stringOpsional
Jenis pool: 0=publik, 1=privat. Default mengikuti logika API lama
01
Contoh: 0
deviceType
stringOpsional
Jenis perangkat: iphone atau ipad. Default iphone
iphoneipad
Contoh: iphone
beizhu
stringOpsional
Catatan
Contoh: 测试设备
code
stringOpsional
Kode aktivasi (opsional)
Contoh: ABC123XYZ

Respon

ParameterTipeWajibDeskripsi
code
numberWajib
Kode status: 1=sukses, 0=gagal
Contoh: 1
msg
stringWajib
Pesan tanggapan
Contoh: 添加成功
data.id
stringWajib
ID Sertifikat / ID reservasi
Contoh: AB12CD34
data.mobileprovision
stringWajib
mobileprovision Base64. Bisa kosong sementara tinjauan sedang berlangsung
Contoh: Base64EncodedString...
data.p12
stringWajib
Sertifikat P12 Base64
Contoh: Base64EncodedString...
Contoh Respon
{
"code":1,
"msg":"Perangkat berhasil ditambahkan",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Kode Kesalahan

Kode Kesalahan3 didefinisikan
0
Token tidak valid
Token tidak valid atau kedaluwarsa
0
Format UDID tidak valid
Panjang UDID harus 25 atau 40
0
Dalam periode tambah-paksa
Loloskan force=true untuk memaksa percobaan tambah baru

X-Lang: en
zh, en, zh-TW, vi, ar

Contoh Kode

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

Catatan

  • Legacy /API/adddevice dan /API/addyydevice tetap tersedia dan kompatibel
  • mode=instant menggunakan kembali logika penambahan instan; mode=review menggunakan kembali logika penambahan reservasi/review
  • Query, x-www-form-urlencoded, dan body JSON didukung; body JSON direkomendasikan untuk V2
  • force=true hanya melewati pemeriksaan periode paksa/lokalisasi/short-circuit yang ada. Apple masih dapat menolak duplikat
  • mode ulasan masih mengikuti batasan API reservasi, misalnya, warranty=4/6 tidak didukung

Coba di Konsol

Isi parameter di bawah ini dan kirim permintaan untuk menguji. Permintaan hanya dikirim ke API situs ini; URL terkunci dan tidak dapat diubah, dan cookie login Anda saat ini disertakan.

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=ABC123XYZTerkunci ke situs ini
stringWajib

Token API pengguna

stringWajib

UDID Perangkat (harus 25 atau 40 karakter)

string

Mode penambahan: instan atau tinjau. Default adalah instan

string

Alias dari mode. Memiliki prioritas dibanding mode

boolean

Tambahkan paksa flag. true/1/yes/y/on melewati pemeriksaan periode paksa dan pemeriksaan sirkuit pendek perangkat yang ada

string

Jenis garansi: 0/1/2/3/4/6. mode tinjau tidak mendukung 4/6

string

Alias lama dari garansi, digunakan hanya ketika garansi kosong

string

Jenis pool: 0=publik, 1=privat. Default mengikuti logika API lama

string

Jenis perangkat: iphone atau ipad. Default iphone

string

Catatan

string

Kode aktivasi (opsional)