Windows 애플리케이션 버전 정보

API 설명: 클라이언트의 버전 번호를 기반으로 해당 버전 정보를检索합니다

📮요청 정보

요청 URL

POST https://api.upgrade.toolsetlink.com/v1/win/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 값이 이미 존재하는지 확인합니다 (중복 요청 방지)

요청 본문

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

요청 본문 매개변수

매개변수 이름	필수	타입	예시 값	설명
winKey	예	string	isVZBUvkFhv6oHxk_X-D0Q	Windows 애플리케이션 고유 식별자
versionCode	예	int	1	클라이언트 버전 코드
arch	예	string	x64	머신 아키텍처: x64, arm64

📮응답 정보

성공 응답 본문

{
  "code": 200,
  "msg": "Version details found",
  "data": {
    "winKey": "isVZBUvkFhv6oHxk_X-D0Q",
    "packageName": "com.a.c",
    "versionName": "v2",
    "versionCode": 2,
    "description": "Description content",
    "pubDate": "2024-02-17T10:34:55+08:00",
    "arch": "x64",
    "releaseNote": "Release note content",
    "changelog": "Changelog content",
    "upgradeMode": 1,
    "forcedUpgradeVersionCode": 1,
    "silentUpgradeVersionCode": 1,
    "target": "win",
    "releaseUrl": "https://example.com/windows-app-v2.exe",
    "updateType": "manual",
    "md5": "md5 value",
    "sha256": "sha256 value",
    "downloadUrl": "https://example.com/windows-app-v2.exe",
    "fileSize": 1024000,
    "downloadTimes": 100,
    "isPreRelease": false
  }
}

응답 본문 매개변수

매개변수 이름	타입	예시 값	설명
winKey	string	isVZBUvkFhv6oHxk_X-D0Q	Windows 애플리케이션 고유 식별자
packageName	string	com.a.c	Windows 애플리케이션 패키지 이름
versionName	string	v2	버전 이름
versionCode	int	2	버전 코드
description	string	Description content	설명 내용
pubDate	string	2024-02-17T10:34:55+08:00	출시 날짜
arch	string	x64	머신 아키텍처
releaseNote	string	Release note content	출시 노트
changelog	string	Changelog content	변경 로그
upgradeMode	int	1	업그레이드 모드
forcedUpgradeVersionCode	int	1	강제 업그레이드 버전 코드
silentUpgradeVersionCode	int	1	무음 업그레이드 버전 코드
target	string	win	타겟 플랫폼
releaseUrl	string	https://example.com/windows-app-v2.exe	출시 URL
updateType	string	manual	업데이트 유형
md5	string	md5 value	MD5 체크섬
sha256	string	sha256 value	SHA256 체크섬
downloadUrl	string	https://example.com/windows-app-v2.exe	다운로드 URL
fileSize	int	1024000	파일 크기 (바이트)
downloadTimes	int	100	다운로드 횟수
isPreRelease	boolean	false	프리 릴리즈 여부

일반적인 오류 응답 본문

{
  "code": 404001,
  "msg": "No available version found",
  "docs": "No corresponding application version found. Please confirm if it has been correctly created in the system. Please refer to the documentation: https://upgrade.toolsetlink.com/en/upgrade/recommend/apk/app-version.html",
  "data": null
}

📊상태 코드

HTTP 상태 코드	code	시나리오 설명	해결 방법
200	200	버전 정보 발견
200	0	현재 버전이 최신
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	내부 서버 데이터 유효성 검사 실패	문의해 주세요 연락처