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

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

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

URL запроса

POST https://api.upgrade.toolsetlink.com/v1/apk/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 (чтобы предотвратить повторные запросы)

Тело запроса

{
  "apkKey": "isVZBUvkFhv6oHxk_X-D0Q",
  "versionCode": 1
}

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

Название параметра	Обязательный	Тип	Пример значения	Описание
apkKey	Да	string	isVZBUvkFhv6oHxk_X-D0Q	Уникальный идентификатор Android-приложения
versionCode	Да	int	1	Код версии клиента

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

Успешный ответ

{
  "code": 200,
  "msg": "Новая версия найдена",
  "data": {
    "apkKey": "isVZBUvkFhv6oHxk_X-D0Q",
    "packageName": "com.a.c",
    "versionName": "v2",
    "versionCode": 2,
    "description": "Содержимое описания"
  }
}

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

Название параметра	Тип	Пример значения	Описание
apkKey	string	isVZBUvkFhv6oHxk_X-D0Q	Уникальный идентификатор Android-приложения
packageName	string	com.a.c	Имя пакета Android-приложения
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	Ошибка валидации данных сервера	Свяжитесь с нами Связаться с нами