Electron-приложение - Получение деталей версии

Описание API: Получение соответствующей подробной информации о версии на основе номера версии клиента

📮 Информация о запросе

URL запроса

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

Заголовки запроса

Название параметра	Обязательный	Тип	Пример значения	Описание
X-Timestamp	Да	string	2025-02-17T10:34:55+08:00	Время запроса в формате RFC3339
X-Nonce	Да	string	fc812cc0b9b51e8c	Уникальная случайная строка (минимум 16 символов)
X-AccessKey	Да	string	mui2W50H1j-OC4xD6PgQag	Секретный ключ AccessKey
X-Signature	Да	string	3603437250c2df51fc46426ac79d8995	Подпись запроса Правила подписи
Content-Type	Да	string	application/json

🔐 Механизм защиты от повторных атак

1. Сервер проверяет, что разница между временными метками запроса и временем сервера не превышает ±5 минут
2. Сервер проверяет, существует ли уже значение Nonce (чтобы предотвратить повторные запросы)

Тело запроса

{
  "electronKey": "isVZBUvkFhv6oHxk_X-D0Q",
  "versionName": "1.0.0",
  "platform": "linux",
  "arch": "x86_64"
}

Параметры тела запроса

Название параметра	Обязательный	Тип	Пример значения	Описание
electronKey	Да	string	isVZBUvkFhv6oHxk_X-D0Q	Уникальный идентификатор Electron-приложения
versionName	Да	string	1.0.0	Номер версии клиента
platform	Да	string	linux	Операционная система: linux, darwin, windows
arch	Да	string	x64	Архитектура машины: x64, arm64

📮 Информация о ответе

Тело успешного ответа

{
  "code": 200,
  "msg": "Получена новая версия",
  "data": {
    "electronKey": "isVZBUvkFhv6oHxk_X-D0Q",
    "versionName": "v2",
    "versionCode": 2,
    "platform": "linux",
    "arch": "x64",
    "description": "Содержимое описания"
  }
}

Параметры тела ответа

Название параметра	Тип	Пример значения	Описание
electronKey	string	isVZBUvkFhv6oHxk_X-D0Q	Уникальный идентификатор Electron-приложения
versionName	string	v1	Название версии
versionCode	int	1	Код версии
description	string	Содержимое описания	Содержимое описания

Типичное тело ответа об ошибке

{
  "code": 404001,
  "msg": "Доступная версия не получена",
  "docs": "Соответствующая версия приложения не найдена, пожалуйста, подтвердите, была ли она правильно создана в системе. Пожалуйста, обратитесь к документации: https://upgrade.toolsetlink.com/ru/upgrade/recommend/apk/app-version.html",
  "data": null
}

📊 Коды состояния

HTTP-код состояния	code	Описание сценария	Решение
200	200	Запрос успешен
400	400001	Недопустимый запрос
400	400002	Отсутствующий параметр
400	400003	Недопустимый параметр
400	400004	Недопустимый заголовок
400	400005	Недопустимое тело
401	401001	Неудачная аутентификация
401	401002	Неудачная проверка подписи
404	404001	Ресурс не найден
404	404002	Запись не найдена
404	404003	Метод обработки не найден
404	404004	Запрос не найден
500	500001	Внутренняя ошибка сервера	Пожалуйста, свяжитесь с нами Связаться с нами
500	500002	Ошибка валидации данных сервера	Пожалуйста, свяжитесь с нами Связаться с нами