Aplicativo Electron - Obter Estratégia de Upgrade

Descrição da API: Com base no número de versão do cliente, recuperar a estratégia de upgrade correspondente, compatível com a interface de upgrade fornecida pelo Electron oficial.

📮 Informações da Requisição

URL da Requisição

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

Cabeçalhos da Requisição

Nome do Parâmetro	Obrigatório	Tipo	Valor de Exemplo	Descrição
X-AccessKey	Sim	string	mui2W50H1j-OC4xD6PgQag	Chave secreta AccessKey

Parâmetros da Requisição

Nome do Parâmetro	Obrigatório	Tipo	Valor de Exemplo	Descrição
electronKey	Sim	string	kPUtUMDIjBhS48q5771pow	Identificador único do aplicativo Electron
versionName	Sim	string	1.0.0	Número da versão
appointVersionName	Não	string	1.2.0	Nome da versão esperada do upgrade, padrão para a versão mais recente se não fornecido
devModelKey	Não	string	stv1	Identificador único do modelo do dispositivo
devKey	Não	string	LOYlLXNy7w	Identificador único do dispositivo (pode usar endereço MAC como identificador único)
platform	Sim	string	linux	Sistema operacional: linux, darwin, windows
arch	Sim	string	x64	Arquitetura da máquina: x64, arm64

📮 Informações da Resposta

Corpo da Resposta Bem-sucedida

{
  "upgradeType": 1,
  "promptUpgradeContent": "Conteúdo da notificação de upgrade",
  "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": ""
}

Corpo da Resposta Bem-sucedida (Já na versão mais recente)

{
  "promptUpgradeContent": "Já na versão mais recente",
  "version": "1.0.0"
}

Quando o sistema determina que a versão solicitada já é a mais recente, o campo version retornará o versionName atualmente solicitado.

Parâmetros do Corpo da Resposta

O conteúdo retornado é consistente com o conteúdo do arquivo yml oficialmente empacotado.

Nome do Parâmetro	Tipo	Valor de Exemplo	Descrição
upgradeType	int		Tipo de notificação de upgrade: 1: Upgrade por prompt; 2: Upgrade silencioso; 3: Upgrade forçado
prompt_upgrade_content	string		Conteúdo da notificação de upgrade
version	string		Número da versão
path	string		Caminho de download do arquivo de atualização
sha512	string		Checksum sha512 do arquivo de atualização

Corpo da Resposta de Erro Típica

{
  "code": 404001,
  "msg": "Nenhuma versão disponível obtida",
  "docs": "Nenhuma versão correspondente da aplicação encontrada, por favor confirme se foi corretamente criada no sistema. Por favor, consulte a documentação: https://upgrade.toolsetlink.com/pt/upgrade/recommend/tauri/app-version.html",
  "data": null
}

📊 Códigos de Status

Código de Status HTTP	Código	Descrição do Cenário	Solução
200		Requisição bem-sucedida, estratégia de upgrade de versão obtida
400	400001	Requisição inválida
400	400002	Parâmetro ausente
400	400003	Parâmetro inválido
400	400004	Cabeçalho inválido
400	400005	Corpo inválido
401	401001	Falha na autenticação
401	401002	Falha na verificação da assinatura
404	404001	Recurso não encontrado
404	404002	Registro não encontrado
404	404003	Método de processamento não encontrado
404	404004	Requisição não encontrada
429	429001	Limite de taxa de requisição de estratégia de tarefa da aplicação	O limite de taxa de requisição configurado para a tarefa de upgrade atual foi atingido, por favor tente novamente mais tarde.
500	500001	Erro interno do servidor	Entre em contato conosco Fale Conosco
500	500002	Falha na verificação de dados interno do servidor	Entre em contato conosco Fale Conosco