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