GETPOST
v2.2.0stable

Añadir Dispositivo V2

API unificada para agregar un solo dispositivo. Cambia entre el modo instantáneo y el modo de reserva con un solo parámetro mientras se mantienen disponibles las API heredadas.

GET | POST/api/adddevice/v2
Autenticación:API Key
Límite:60/minuto

Parámetros de solicitud

Todos los parámetros se pueden pasar vía Consulta o Cuerpo

ParámetroTipoRequeridoDescripción
token
stringRequerido
Token de API de usuario
Ejemplo: your_api_token_here
udid
stringRequerido
UDID del dispositivo (debe tener 25 o 40 caracteres)
Ejemplo: 00008030-001234567890ABCD
mode
stringOpcional
Modo de adición: instantáneo o revisión. El predeterminado es instantáneo
instantreview
Ejemplo: instant
add_mode
stringOpcional
Alias del modo. Tiene prioridad sobre el modo
instantreview
Ejemplo: review
force
booleanOpcional
Forzar agregar bandera. true/1/yes/y/on omite las verificaciones de período forzado y de circuito corto de dispositivo existente
Ejemplo: true
warranty
stringOpcional
Tipo de garantía: 0/1/2/3/4/6. El modo de revisión no admite 4/6
012346
Ejemplo: 1
shtype
stringOpcional
Alias heredado de la garantía, usado solo cuando la garantía está vacía
012346
Ejemplo: 1
type
stringOpcional
Tipo de grupo: 0=público, 1=privado. Los valores predeterminados siguen la lógica de la API heredada
01
Ejemplo: 0
deviceType
stringOpcional
Tipo de dispositivo: iphone o ipad. Predeterminado iphone
iphoneipad
Ejemplo: iphone
beizhu
stringOpcional
Observación
Ejemplo: 测试设备
code
stringOpcional
Código de activación (opcional)
Ejemplo: ABC123XYZ

Respuesta

ParámetroTipoRequeridoDescripción
code
numberRequerido
Código de estado: 1=éxito, 0=fallo
Ejemplo: 1
msg
stringRequerido
Mensaje de respuesta
Ejemplo: 添加成功
data.id
stringRequerido
ID de certificado / ID de reserva
Ejemplo: AB12CD34
data.mobileprovision
stringRequerido
mobileprovision Base64. Puede estar vacío mientras la revisión esté pendiente
Ejemplo: Base64EncodedString...
data.p12
stringRequerido
Certificado P12 Base64
Ejemplo: Base64EncodedString...
Ejemplo de respuesta
{
"code":1,
"msg":"Dispositivo agregado con éxito",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Códigos de error

Códigos de error3 definido
0
Token inválido
Token inválido o expirado
0
Formato de UDID inválido
La longitud de UDID debe ser 25 o 40
0
Dentro del período de adición forzada
Pase force=true para forzar un nuevo intento de adición

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

Ejemplos de código

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

Notas

  • Las antiguas /API/adddevice y /API/addyydevice siguen estando disponibles y son compatibles
  • mode=instant reutiliza la lógica de adición instantánea; mode=review reutiliza la lógica de adición de reserva/revisión
  • Se admiten Query, x-www-form-urlencoded y cuerpo JSON; se recomienda el cuerpo JSON para V2
  • force=true solo omite las comprobaciones locales de período de fuerza/atajo existente. Apple aún puede rechazar duplicados
  • El modo de revisión todavía sigue las restricciones de la API de reservas, por ejemplo, warranty=4/6 no es compatible

Pruébalo en la Consola

Complete los parámetros a continuación y envíe una solicitud para probar. Las solicitudes solo van a la API de este sitio; la URL está bloqueada y no se puede cambiar, y se incluye su cookie de inicio de sesión actual.

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=ABC123XYZBloqueado a este sitio
stringRequerido

Token de API de usuario

stringRequerido

UDID del dispositivo (debe tener 25 o 40 caracteres)

string

Modo de adición: instantáneo o revisión. El predeterminado es instantáneo

string

Alias del modo. Tiene prioridad sobre el modo

boolean

Forzar agregar bandera. true/1/yes/y/on omite las verificaciones de período forzado y de circuito corto de dispositivo existente

string

Tipo de garantía: 0/1/2/3/4/6. El modo de revisión no admite 4/6

string

Alias heredado de la garantía, usado solo cuando la garantía está vacía

string

Tipo de grupo: 0=público, 1=privado. Los valores predeterminados siguen la lógica de la API heredada

string

Tipo de dispositivo: iphone o ipad. Predeterminado iphone

string

Observación

string

Código de activación (opcional)