Aplicación Electron - Obtener Estrategia de Actualización

Descripción de la API: Basado en el número de versión del cliente, recuperar la estrategia de actualización correspondiente, compatible con la interfaz de actualización proporcionada por Electron oficial.

📮 Información de Solicitud

URL de Solicitud

GET http://0.0.0.0:8888/v1/electron/upgrade?electronKey=kPUtUMDIjBhS48q5771pow&versionName=1.1.1&appointVersionName=&devModelKey=&devKey=&platform=darwin&arch=arm64

Encabezados de Solicitud

Nombre del Parámetro	Requerido	Tipo	Valor de Ejemplo	Descripción
X-AccessKey	Sí	string	mui2W50H1j-OC4xD6PgQag	Clave secreta AccessKey

Parámetros de Solicitud

Nombre del Parámetro	Requerido	Tipo	Valor de Ejemplo	Descripción
electronKey	Sí	string	kPUtUMDIjBhS48q5771pow	Identificador único de la aplicación Electron
versionName	Sí	string	1.0.0	Número de versión
appointVersionName	No	string	1.2.0	Nombre de versión de actualización esperada, por defecto la versión más reciente si no se proporciona
devModelKey	No	string	stv1	Identificador único del modelo de dispositivo
devKey	No	string	LOYlLXNy7w	Identificador único del dispositivo (puede usar dirección MAC como identificador único)
platform	Sí	string	linux	Sistema operativo: linux, darwin, windows
arch	Sí	string	x64	Arquitectura de máquina: x64, arm64

📮 Información de Respuesta

Cuerpo de Respuesta Exitosa

{
  "upgradeType": 1,
  "promptUpgradeContent": "Contenido de notificación de actualización",
  "version": "1.2.0",
  "files": [
    {
      "url": "https://api.upgrade.toolsetlink.com/v1/electron/download.AppImage?electronKey=kPUtUMDIjBhS48q5771pow&versionId=7",
      "sha512": "sNEx4hgG+cxFAULCDl9uOXJN+i4o/ND0adGphOP4Atbthvfmqb4uyLTENrrCyAIy0zaRxmFtI2aHiS/Da2uOyw==",
      "size": 153453614
    },
    {
      "url": "https://api.upgrade.toolsetlink.com/v1/electron/download.AppImage?electronKey=kPUtUMDIjBhS48q5771pow&versionId=7",
      "sha512": "sNEx4hgG+cxFAULCDl9uOXJN+i4o/ND0adGphOP4Atbthvfmqb4uyLTENrrCyAIy0zaRxmFtI2aHiS/Da2uOyw==",
      "size": 153453614
    }
  ],
  "path": "https://api.upgrade.toolsetlink.com/v1/electron/download.AppImage?electronKey=kPUtUMDIjBhS48q5771pow&versionId=7",
  "sha512": "sSrgmnph5Cr2AuZwCEWXD90JiJ2JW0RnqLf8cXSxusHLssCPRlAFtpER74Rlw/LglbOlcYvh+IO3jsAxAdLQmw==",
  "releaseDate": ""
}

Cuerpo de Respuesta Exitosa (Ya en la versión más reciente)

{
  "promptUpgradeContent": "Ya es la versión más reciente",
  "version": "1.0.0"
}

Cuando el sistema determina que la versión solicitada ya es la más reciente, el campo version devolverá el versionName actualmente solicitado.

Parámetros del Cuerpo de la Respuesta

El contenido devuelto es consistente con el contenido del archivo yml empaquetado oficialmente.

Nombre del Parámetro	Tipo	Valor de Ejemplo	Descripción
upgradeType	int		Tipo de notificación de actualización: 1: Actualización con aviso; 2: Actualización silenciosa; 3: Actualización forzada
prompt_upgrade_content	string		Contenido de notificación de actualización
version	string		Número de versión
path	string		Ruta de descarga del archivo de actualización
sha512	string		Suma de verificación sha512 del archivo de actualización

Cuerpo de Respuesta de Error Típica

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

📊 Códigos de Estado

Código de Estado HTTP	Code	Descripción del Escenario	Solución
200		Solicitud exitosa, obtuvo estrategia de actualización de versión
400	400001	Solicitud inválida
400	400002	Parámetro faltante
400	400003	Parámetro inválido
400	400004	Encabezado inválido
400	400005	Cuerpo 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 actual, por favor inténtalo de nuevo más tarde.
500	500001	Error interno del servidor	Por favor contáctenos Contacto
500	500002	Validación de datos interna del servidor fallida	Por favor contáctenos Contacto