Добавить Устройство V2
Унифицированный API для добавления одного устройства. Переключение между мгновенным режимом и режимом бронирования одним параметром при сохранении доступности устаревших API.
/api/adddevice/v2Параметры запроса
Все параметры можно передавать через Query или Body
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
token | string | Обязательный | Токен API пользователя Пример: your_api_token_here |
udid | string | Обязательный | UDID устройства (должен быть 25 или 40 символов) Пример: 00008030-001234567890ABCD |
mode | string | Опционально | Режим добавления: мгновенный или проверка. По умолчанию мгновенный instantreview Пример: instant |
add_mode | string | Опционально | Псевдоним режима. Имеет приоритет над mode instantreview Пример: review |
force | boolean | Опционально | Флаг принудительного добавления. true/1/yes/y/on пропускает проверки принудительного периода и короткого замыкания существующего устройства Пример: 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... |
Коды ошибок
000X-Lang: enzh, 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"
}'Примечания
- Устаревшие /API/adddevice и /API/addyydevice остаются доступными и совместимыми
- режим=instant повторно использует логику мгновенного добавления; режим=review повторно использует логику добавления через резервирование/проверку
- поддерживаются Query, x-www-form-urlencoded и JSON body; рекомендуется использовать JSON body для V2
- force=true только пропускает локальные проверки force-period/существующих коротких замыканий. Apple всё ещё может отклонить дубликаты
- режим просмотра по-прежнему соблюдает ограничения API бронирования, например, 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Заблокировано для этого сайтаТокен API пользователя
UDID устройства (должен быть 25 или 40 символов)
Режим добавления: мгновенный или проверка. По умолчанию мгновенный
Псевдоним режима. Имеет приоритет над mode
Флаг принудительного добавления. true/1/yes/y/on пропускает проверки принудительного периода и короткого замыкания существующего устройства
Тип гарантии: 0/1/2/3/4/6. Режим обзора не поддерживает 4/6
Устаревший псевдоним гарантии, используется только когда гарантия пуста
Тип пула: 0=публичный, 1=приватный. По умолчанию следует логике устаревшего API
Тип устройства: iphone или ipad. По умолчанию iphone
Примечание
Активирующий код (необязательно)