Volver al InicioDocumentación API
Idioma: Español
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
Volver a Documentos
GETPOST
v2.1.0stable

Añadir Dispositivo con Reserva

Registrar un dispositivo en modo de reserva. mobileprovision puede estar vacío mientras la revisión de Apple esté pendiente

GET | POST/api/addyydevice
Autenticación:API Key
Límite:30/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. La longitud debe ser de 25 o 40 caracteres
Ejemplo: 00008030-001234567890ABCD
warranty
stringOpcional
Tipo de garantía: 0/1/2/3/4/6. Se recomienda pasarlo explícitamente
012346
Ejemplo: 1
shtype
stringOpcional
Alias de garantía. Usado solo cuando la garantía está vacía
012346
Ejemplo: 1
type
stringOpcional
Tipo de grupo: 0=compartido, 1=dedicado. Por defecto es 0
01
Ejemplo: 0
deviceType
stringOpcional
Tipo de dispositivo: iphone o ipad. Por defecto es iphone
iphoneipad
Ejemplo: iphone
beizhu
stringOpcional
Observación. Hasta 40 caracteres
Ejemplo: 预约测试设备

Respuesta

ParámetroTipoRequeridoDescripción
code
numberRequerido
Código de estado: 1=éxito, 0=fallo
Ejemplo: 1
msg
stringRequerido
Mensaje de respuesta
Ejemplo: 添加成功
time
numberRequerido
Marca de tiempo del servidor (segundos Unix)
Ejemplo: 1769675945
data
objectRequerido
Carga útil de la respuesta
data.id
stringRequerido
ID de orden de reserva / certificado (típicamente 5 caracteres alfanuméricos)
Ejemplo: A1B2C
data.pool
numberRequerido
Grupo: 0=compartido, 1=dedicado
Ejemplo: 0
data.addtime
numberRequerido
Hora de adición (Unix)
Ejemplo: 1706500000
data.mobileprovision
stringRequerido
mobileprovision codificado en Base64 (puede estar vacío mientras la revisión está pendiente)
Ejemplo: Base64EncodedString...
data.p12
stringRequerido
Certificado P12 codificado en Base64
Ejemplo: Base64EncodedString...
data.state
booleanRequerido
Estado de validez del certificado (devuelto en algunas sucursales)
Ejemplo: true
ysucc
stringRequerido
Indicador de éxito, devuelve "Ysucc" en caso de éxito
Ejemplo: Ysucc
Ejemplo de respuesta
{
"code":1,
"msg":"Reserva exitosa",
"time":1769675945,
"data":
{
"id":"A1B2C",
"pool":0,
"addtime":1706500000,
"mobileprovision":"",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Códigos de error

Códigos de error4 definido
0
Token inválido
Token inválido o expirado
0
Formato de UDID inválido
La longitud de UDID debe ser de 25 o 40 caracteres
0
Saldo insuficiente
Saldo insuficiente

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/addyydevice" \
  -H "X-Lang: en" \
  -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"

Notas

  • Envía los parámetros a través de Query o x-www-form-urlencoded. El cuerpo JSON no se analiza
  • shtype es un alias heredado de warranty, utilizado solo cuando warranty está vacío
  • Un mobileprovision vacío usualmente indica que la revisión está pendiente; verifica el estado mediante las API de lista de dispositivos

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/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%87Bloqueado a este sitio
stringRequerido

Token de API de usuario

stringRequerido

UDID del dispositivo. La longitud debe ser de 25 o 40 caracteres

string

Tipo de garantía: 0/1/2/3/4/6. Se recomienda pasarlo explícitamente

string

Alias de garantía. Usado solo cuando la garantía está vacía

string

Tipo de grupo: 0=compartido, 1=dedicado. Por defecto es 0

string

Tipo de dispositivo: iphone o ipad. Por defecto es iphone

string

Observación. Hasta 40 caracteres