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