Detalles de Versión de Aplicación Windows

Descripción de la API: Basado en el número de versión del cliente, recuperar los detalles de versión correspondientes

📮 Información de la Solicitud

URL de la Solicitud

POST https://api.upgrade.toolsetlink.com/v1/win/version

Encabezados de la Solicitud

Nombre del Parámetro	Requerido	Tipo	Valor de 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

{
  "winKey": "isVZBUvkFhv6oHxk_X-D0Q",
  "versionCode": 1,
  "arch": "x64"
}

Parámetros del Cuerpo de la Solicitud

Nombre del Parámetro	Requerido	Tipo	Valor de Ejemplo	Descripción
winKey	Sí	string	isVZBUvkFhv6oHxk_X-D0Q	Identificador único de la aplicación Windows
versionCode	Sí	int	1	Código de versión del cliente
arch	Sí	string	x64	Arquitectura de la máquina: x64, arm64

📮 Información de la Respuesta

Cuerpo de la Respuesta Exitosa

{
  "code": 200,
  "msg": "Detalles de versión encontrados",
  "data": {
    "winKey": "isVZBUvkFhv6oHxk_X-D0Q",
    "packageName": "com.a.c",
    "versionName": "v2",
    "versionCode": 2,
    "description": "Contenido de la descripción",
    "pubDate": "2024-02-17T10:34:55+08:00",
    "arch": "x64",
    "releaseNote": "Contenido de las notas de lanzamiento",
    "changelog": "Contenido del registro de cambios",
    "upgradeMode": 1,
    "forcedUpgradeVersionCode": 1,
    "silentUpgradeVersionCode": 1,
    "target": "win",
    "releaseUrl": "https://example.com/windows-app-v2.exe",
    "updateType": "manual",
    "md5": "valor md5",
    "sha256": "valor sha256",
    "downloadUrl": "https://example.com/windows-app-v2.exe",
    "fileSize": 1024000,
    "downloadTimes": 100,
    "isPreRelease": false
  }
}

Parámetros del Cuerpo de la Respuesta

Nombre del Parámetro	Tipo	Valor de Ejemplo	Descripción
winKey	string	isVZBUvkFhv6oHxk_X-D0Q	Identificador único de la aplicación Windows
packageName	string	com.a.c	Nombre del paquete de la aplicación Windows
versionName	string	v2	Nombre de la versión
versionCode	int	2	Código de la versión
description	string	Contenido de la descripción	Contenido de la descripción
pubDate	string	2024-02-17T10:34:55+08:00	Fecha de publicación
arch	string	x64	Arquitectura de la máquina
releaseNote	string	Contenido de las notas de lanzamiento	Notas de lanzamiento
changelog	string	Contenido del registro de cambios	Registro de cambios
upgradeMode	int	1	Modo de actualización
forcedUpgradeVersionCode	int	1	Código de versión de actualización forzada
silentUpgradeVersionCode	int	1	Código de versión de actualización silenciosa
target	string	win	Plataforma objetivo
releaseUrl	string	https://example.com/windows-app-v2.exe	URL de lanzamiento
updateType	string	manual	Tipo de actualización
md5	string	valor md5	Suma de verificación MD5
sha256	string	valor sha256	Suma de verificación SHA256
downloadUrl	string	https://example.com/windows-app-v2.exe	URL de descarga
fileSize	int	1024000	Tamaño del archivo (bytes)
downloadTimes	int	100	Número de descargas
isPreRelease	boolean	false	Es versión preliminar

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/apk/app-version.html",
  "data": null
}

📊 Códigos de Estado

Código de Estado HTTP	código	Descripción del Escenario	Solución
200	200	Detalles de versión encontrados
200	0	La versión actual es la más reciente
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
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