Tauri アプリケーションアップグレード戦略 API
API 説明：クライアントのバージョン番号に基づいて、対応するアップグレード戦略を取得します。Tauri 公式が提供するファイルアップグレードインターフェースのレスポンス情報と互換性があります。tauri dynamic update
📮 リクエスト情報
リクエスト URL
GET https://api.upgrade.toolsetlink.com/v1/tauri/upgrade?tauriKey=a0jtz0HUwL66r7gCGvbMKQ&versionName=1.0.0&appointVersionCode=0&devModelKey=&devKey=&target=linux&arch=x86_64
リクエストヘッダー
| パラメータ名 | 必須 | 型 | 例 | 説明 |
|---|---|---|---|---|
| X-AccessKey | Yes | string | mui2W50H1j-OC4xD6PgQag | シークレット AccessKey |
リクエストパラメータ説明
| パラメータ名 | 必須 | 型 | 例 | 説明 |
|---|---|---|---|---|
| tauriKey | Yes | string | a0jtz0HUwL66r7gCGvbMKQ | Tauri アプリケーションの一意の識別子 |
| versionName | Yes | string | 1.0.0 | システムに記録されているバージョン名 |
| appointVersionName | No | string | 1.0.1 | 希望するアップグレードバージョン名、指定なしで最新バージョン |
| appointVersionCode | No | int | 0 | 希望するアップグレードバージョンコード、指定なしまたは 0 で最新バージョン |
| devModelKey | No | string | stv1 | デバイスモデルの一意の識別子 |
| devKey | No | string | LOYlLXNy7w | デバイスの一意の識別子（MAC アドレスを使用できます） |
| target | Yes | string | linux | オペレーティングシステム: linux, darwin, windows |
| arch | Yes | string | x86_64 | マシンアーキテクチャ: x86_64, i686, aarch64, armv7 |
📮 レスポンス情報
成功レスポンスボディ
json
{
"version": "2.0.0",
"notes": "アップグレード通知",
"pub_date": "2025-05-26T20:40:30+08:00",
"url": "https://upgradelink.oss-cn-beijing.aliyuncs.com/upgrade/2025-05-26/other/01970c9b-be88-70db-b4bd-92303c8d1fef.json?x-oss-credential=LTAI5tA5mxKLLfa6FxPoTkqE%2F20250527%2Fcn-beijing%2Foss%2Faliyun_v4_request&x-oss-date=20250527T135625Z&x-oss-expires=600&x-oss-signature=fc961fcd21ecd763946ec123be1ef0504713f2189036fe57b687ed2917b570e8&x-oss-signature-version=OSS4-HMAC-SHA256",
"signature": "",
"upgradeType": 1
}レスポンスボディパラメータ説明
返される内容は、公式の Tauri 動的更新インターフェースと一致しています。tauri dynamic update
| パラメータ名 | 型 | 例 | 説明 |
|---|---|---|---|
| version | string | 2.0.0 | バージョン番号 |
| notes | string | アップグレード通知 | 更新説明 |
| pub_date | string | 2025-05-26T20:40:30+08:00 | バージョンリリース日 |
| url | string | ダウンロード URL | バージョンファイル URL |
| signature | string | 生成された .sig ファイルの内容 | |
| upgradeType | int | 1 | アップグレードプロンプトタイプ: 1: プロンプトアップグレード; 2: サイレントアップグレード; 3: 強制アップグレード |
典型的なエラーレスポンスボディ
json
{
"code": 404001,
"msg": "利用可能なバージョンが見つかりません",
"docs": "対応するアプリケーションバージョンが見つかりません。システムに正しく作成されているか確認してください。ドキュメントを参照してください：https://upgrade.toolsetlink.com/ja/upgrade/recommend/tauri/app-version.html",
"data": null
}📊 ステータスコード
| HTTP ステータスコード | コード | シナリオ説明 | 解決策 |
|---|---|---|---|
| 200 | リクエスト成功、バージョンアップグレード戦略を取得 | ||
| 204 | 既に最新バージョンです | ||
| 400 | 400001 | 無効なリクエスト | |
| 400 | 400002 | パラメータが不足しています | |
| 400 | 400003 | 無効なパラメータ | |
| 400 | 400004 | 無効なヘッダー | |
| 400 | 400005 | 無効なリクエストボディ | |
| 401 | 401001 | 認証に失敗しました | |
| 401 | 401002 | 署名検証に失敗しました | |
| 404 | 404001 | リソースが見つかりません | |
| 404 | 404002 | レコードが見つかりません | |
| 404 | 404003 | 処理方法が見つかりません | |
| 404 | 404004 | リクエストが見つかりません | |
| 429 | 429001 | アプリケーションタスク戦略のリクエストレート制限 | 現在のアップグレードタスクに設定されているリクエストレート制限に達しました。後でもう一度お試しください。 |
| 500 | 500001 | サーバー内部エラー | お問い合わせください お問い合わせ |
| 500 | 500002 | サーバー内部データ検証に失敗しました | お問い合わせください お問い合わせ |