URL アプリケーション - バージョン詳細の取得

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

📮 リクエスト情報

リクエスト URL

POST https://api.upgrade.toolsetlink.com/v1/url/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 値が既に存在するかどうかを確認します（重複リクエストを防止するため）

リクエストボディ

{
  "urlKey": "LOYlLXNy7wV3ySuh0XgtSg",
  "versionCode": 1
}

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

パラメータ名	必須	型	例	説明
urlKey	Yes	string	LOYlLXNy7wV3ySuh0XgtSg	URL アプリケーションの一意の識別子
versionCode	Yes	int	1	クライアントのバージョンコード

📮 レスポンス情報

成功レスポンスボディ

{
  "code": 200,
  "msg": "バージョン詳細が見つかりました",
  "data": {
    "urlKey": "LOYlLXNy7wV3ySuh0XgtSg",
    "versionName": "v2",
    "versionCode": 2,
    "description": "バージョン説明"
  }
}

レスポンスボディパラメータ説明

パラメータ名	型	例	説明
urlKey	string	LOYlLXNy7wV3ySuh0XgtSg	URL アプリケーションの一意の識別子
versionName	string	v1	バージョン名
versionCode	int	1	バージョンコード
description	string	バージョン説明	バージョン説明コンテンツ

典型的なエラーレスポンスボディ

{
  "code": 404001,
  "msg": "利用可能なバージョンが見つかりません",
  "docs": "対応するアプリケーションバージョンが見つかりません。システムに正しく作成されているか確認してください。ドキュメントを参照してください：https://upgrade.toolsetlink.com/ja/upgrade/recommend/url/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	サーバー内部データ検証に失敗しました	お問い合わせください お問い合わせ