Estrategia de Actualización de Aplicación URL

Descripción de la API: Basado en el número de versión del cliente, obtener la estrategia de actualización correspondiente

📮 Información de la Solicitud

URL de la Solicitud

POST https://api.upgrade.toolsetlink.com/v1/url/upgrade

Encabezados de la Solicitud

Nombre del Parámetro	Requerido	Tipo	Ejemplo	Descripción
X-Timestamp	Sí	string	2025-02-17T10:34:55+08:00	Hora de la solicitud en formato RFC3339
X-Nonce	Sí	string	fc812cc0b9b51e8c	Cadena aleatoria única (al menos 16 caracteres)
X-AccessKey	Sí	string	mui2W50H1j-OC4xD6PgQag	Clave secreta - AccessKey
X-Signature	Sí	string	3603437250c2df51fc46426ac79d8995	Firma de la solicitud Reglas de Firma
Content-Type	Sí	string	application/json

🔐 Mecanismo Anti-replay

1. El servidor verifica que la diferencia de tiempo con la hora del servidor no exceda ±5 minutos
2. El servidor verifica si el valor Nonce ya existe (para evitar solicitudes duplicadas)

Cuerpo de la Solicitud

{
  "urlKey": "SkEgKQ4SyLmzazl31fJnAw",
  "versionCode": 1,
  "appointVersionCode": 0,
  "devModelKey": "stv1",
  "devKey": "LOYlLXNy7w"
}

Descripción de los Parámetros del Cuerpo de la Solicitud

Nombre del Parámetro	Requerido	Tipo	Ejemplo	Descripción
urlKey	Sí	string	SkEgKQ4SyLmzazl31fJnAw	Identificador único de la aplicación URL
versionCode	Sí	int	1	Código de versión registrado en el sistema
appointVersionCode	No	int	2	Código de versión de actualización esperado, 0 para la versión más reciente
devModelKey	No	string	stv1	Identificador único del modelo del dispositivo
devKey	No	string	89c8b3d5f2a74e1b	Identificador único del dispositivo (se puede usar la dirección MAC)

📮 Información de la Respuesta

Cuerpo de la Respuesta Exitosa

{
  "code": 200,
  "msg": "Nueva versión encontrada",
  "data": {
    "urlKey": "SkEgKQ4SyLmzazl31fJnAw",
    "versionName": "v2",
    "versionCode": 2,
    "urlPath": "http://file.com/2.exe",
    "upgradeType": 1,
    "promptUpgradeContent": "Contenido del mensaje"
  }
}

Descripción de los Parámetros del Cuerpo de la Respuesta

Nombre del Parámetro	Tipo	Ejemplo	Descripción
urlKey	string	SkEgKQ4SyLmzazl31fJnAw	Identificador único de la aplicación URL
versionName	string	v1	Nombre de la versión
versionCode	int	1	Código de la versión
urlPath	string	http://file.com/2.exe	Dirección de descarga del archivo
upgradeType	int	1	Tipo de actualización: 1: Actualización solicitada; 2: Actualización silenciosa; 3: Actualización forzada
promptUpgradeContent	string	Código optimizado	Descripción de actualización solicitada

Cuerpo de la Respuesta de Error Típica

{
  "code": 404001,
  "msg": "No se encontró versión disponible",
  "docs": "No se encontró la versión de la aplicación correspondiente. Por favor confirme si se ha creado correctamente en el sistema. Consulte la documentación: https://upgrade.toolsetlink.com/en/upgrade/recommend/url/app-version.html",
  "data": null
}

📊 Códigos de Estado

Código de Estado HTTP	código	Descripción del Escenario	Solución
200	0	Solicitud exitosa, la versión actual es la más reciente
200	200	Solicitud exitosa, estrategia de actualización obtenida
400	400001	Solicitud inválida
400	400002	Parámetros faltantes
400	400003	Parámetros inválidos
400	400004	Encabezados inválidos
400	400005	Cuerpo de la solicitud inválido
401	401001	Autenticación fallida
401	401002	Verificación de firma fallida
404	404001	Recurso no encontrado
404	404002	Registro no encontrado
404	404003	Método de procesamiento no encontrado
404	404004	Solicitud no encontrada
429	429001	Límite de velocidad de solicitud de estrategia de tarea de aplicación	Se ha alcanzado el límite de velocidad de solicitud configurado para la tarea de actualización, por favor inténtelo de nuevo más tarde.
500	500001	Error interno del servidor	Por favor contáctenos Contáctenos
500	500002	Fallo en la validación de datos internos del servidor	Por favor contáctenos Contáctenos