ファイルアプリケーション初回ダウンロード URL
API 説明：バージョン番号に基づいて対応するバージョンをダウンロードします。バージョン番号が指定されていない場合、デフォルトで最新バージョンが使用されます。
ユーザーがアプリケーションを初めてダウンロードする場合、最新バージョンをダウンロードする必要があります。この API のリクエストアドレスは固定されています。バージョン番号が指定されていない場合、自動的に最新のアップロードされたバージョンを取得するため、固定のダウンロードボタンでの使用に適しています。
📮 リクエスト情報
リクエスト URL
GET https://api.upgrade.toolsetlink.com/v1/file/download?fileKey=LOYlLXNy7wV3ySuh0XgtSg&versionCode=1
リクエストパラメータ
| パラメータ名 | 必須 | 型 | 例値 | 説明 |
|---|---|---|---|---|
| fileKey | Yes | string | LOYlLXNy7wV3ySuh0XgtSg | 一意のファイルアプリケーション識別子 |
| versionCode | No | int | 1 | アプリケーションバージョン番号、指定されていない場合は最新バージョン |
📮 レスポンス情報
成功
直接ファイルダウンロードが開始されます
典型的なエラーレスポンスボディ
json
{
"code": 404001,
"msg": "利用可能なバージョンが取得できません",
"docs": "対応するアプリケーションバージョンが見つかりません。システムに正しく作成されているか確認してください。ドキュメントを参照してください：https://upgrade.toolsetlink.com/ja/upgrade/recommend/file/app-version.html",
"data": null
}📊 ステータスコード
| HTTP ステータスコード | コード | シナリオ説明 | 解決策 |
|---|---|---|---|
| 200 | 直接ファイルダウンロードが開始されます | ||
| 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 | サーバー内部データ検証に失敗しました | お問い合わせください お問い合わせ |