Electron アプリ - バージョン詳細の取得

API 説明：クライアントのバージョン番号に基づいて、対応する詳細なバージョン情報を取得します

📮 リクエスト情報

リクエスト URL

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

リクエストヘッダー

パラメータ名	必須	型	例	説明
X-Timestamp	Yes	string	2025-02-17T10:34:55+08:00	RFC3339 形式のリクエスト時間
X-Nonce	Yes	string	fc812cc0b9b51e8c	一意のランダム文字列（少なくとも 16 文字）
X-AccessKey	Yes	string	mui2W50H1j-OC4xD6PgQag	シークレットキー AccessKey
X-Signature	Yes	string	3603437250c2df51fc46426ac79d8995	リクエスト署名 署名ルール
Content-Type	Yes	string	application/json

🔐 リプレイ攻撃防止メカニズム

1. サーバーは、リクエストとサーバー時間のタイムスタンプの差が ±5 分を超えないことを検証します
2. サーバーは、Nonce 値が既に存在するかどうかを確認します（重複リクエストを防止するため）

リクエストボディ

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

リクエストボディパラメータ

パラメータ名	必須	型	例	説明
electronKey	Yes	string	isVZBUvkFhv6oHxk_X-D0Q	Electron アプリの一意の識別子
versionName	Yes	string	1.0.0	クライアントバージョン番号
platform	Yes	string	linux	オペレーティングシステム: linux, darwin, windows
arch	Yes	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/ja/upgrade/recommend/electron/app-version.html",
  "data": null
}

📊 ステータスコード

HTTP ステータスコード	コード	シナリオ説明	解決策
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	サーバー内部データ検証に失敗しました	お問い合わせください お問い合わせ