GETPOST
v2.2.0stable

Add Device V2

Unified single-device add API. Switch between instant and reservation mode with one parameter while keeping legacy APIs available.

GET | POST/api/adddevice/v2
Афіша:API Key
Ліміт:60/minute

Параметри запиту

Всі параметри можуть бути передані через Query або тіло

ПараметрТипПотрібніОпис
token
stringПотрібні
User API token
Приклад: your_api_token_here
udid
stringПотрібні
Device UDID (must be 25 or 40 characters)
Приклад: 00008030-001234567890ABCD
mode
stringДодатково
Add mode: instant or review. Default is instant
instantreview
Приклад: instant
add_mode
stringДодатково
Alias of mode. Takes priority over mode
instantreview
Приклад: review
force
booleanДодатково
Force add flag. true/1/yes/y/on skips force-period and existing-device short-circuit checks
Приклад: true
warranty
stringДодатково
Warranty type: 0/1/2/3/4/6. review mode does not support 4/6
012346
Приклад: 1
shtype
stringДодатково
Legacy alias of warranty, used only when warranty is empty
012346
Приклад: 1
type
stringДодатково
Pool type: 0=public, 1=private. Defaults follow legacy API logic
01
Приклад: 0
deviceType
stringДодатково
Device type: iphone or ipad. Default iphone
iphoneipad
Приклад: iphone
beizhu
stringДодатково
Remark
Приклад: 测试设备
code
stringДодатково
Activation code (optional)
Приклад: ABC123XYZ

Відправити

ПараметрТипПотрібніОпис
code
numberПотрібні
Status code: 1=success, 0=failure
Приклад: 1
msg
stringПотрібні
Response message
Приклад: 添加成功
data.id
stringПотрібні
Certificate ID / reservation ID
Приклад: AB12CD34
data.mobileprovision
stringПотрібні
Base64 mobileprovision. May be empty while review is pending
Приклад: Base64EncodedString...
data.p12
stringПотрібні
Base64 P12 certificate
Приклад: Base64EncodedString...
Приклад відповіді
{
"code":1,
"msg":"Device added successfully",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Коди помилок

Коди помилок3 визначено
0
Invalid token
Invalid or expired token
0
Invalid UDID format
UDID length must be 25 or 40
0
Within force-add period
Pass force=true to force a new add attempt

Мова відповіді

Налаштуйте мову відповіді API з заголовком X-Lang. Приклади коду нижче автоматично використовуйте мову поточного сайту.

Рекомендований заголовок
X-Lang: uk
Підтримувані мови
zh, en, zh-TW, vi, ar, es, ru

За підтримки X-Lang бере на себе пріоритет. Непідтримувані мови слідувати мовою сайту.

Приклади коду

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

Нотатки

  • 旧接口 /api/adddevice 和 /api/addyydevice 仍保留并保持兼容
  • mode=instant 复用秒出添加逻辑;mode=review 复用预约/审核添加逻辑
  • 支持 Query、x-www-form-urlencoded 和 JSON body;JSON body 更推荐用于 V2
  • force=true 仅跳过本系统强制添加期/已存在短路判断,不保证 Apple 侧一定允许重复注册
  • review 模式仍遵循预约接口限制,例如不支持 warranty=4/6

Спробуйте в Консоль

Заповнювати параметри нижче і відправити запит на тест. Запити тільки перейти до цього API сайту; URL-адреса заблокована і не може бути змінена, і ваш поточний логін cookie включено.

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Потрібні

User API token

stringПотрібні

Device UDID (must be 25 or 40 characters)

string

Add mode: instant or review. Default is instant

string

Alias of mode. Takes priority over mode

boolean

Force add flag. true/1/yes/y/on skips force-period and existing-device short-circuit checks

string

Warranty type: 0/1/2/3/4/6. review mode does not support 4/6

string

Legacy alias of warranty, used only when warranty is empty

string

Pool type: 0=public, 1=private. Defaults follow legacy API logic

string

Device type: iphone or ipad. Default iphone

string

Remark

string

Activation code (optional)