# ブラウザカーネルのダウンロード

ブラウザカーネルをダウンロードしてインストールします。1リクエストあたり最大20個のカーネルのバッチダウンロードをサポートします。この操作のタイムアウトは最大約30分です。呼び出し側のタイムアウトは1805秒以上に設定してください。
MoreLoginクライアントバージョン **2.61.1** 以上が必要です。
### 重複リクエストの処理
- 同一リクエスト内で同じブラウザタイプとメジャーバージョンが複数回出現した場合、検索とダウンロードは1回のみ実行されますが、各エントリにはそれぞれの結果が返されます。
- 同じバージョンへの同時リクエストは、新しいダウンロードを開始する代わりに進行中のタスクに参加します。
- リクエストされたバージョンが最新のマイナーバージョンで既にインストールされている場合、ステータスは
`already_installed`
 になります。
- 古いマイナーバージョンがインストールされている場合、利用可能な最新のマイナーバージョンに更新されます。

### エラーコードリファレンス
| errorCode | 説明 |
|  --- | --- |
| `INVALID_JSON` | JSON形式エラー |
| `INVALID_REQUEST` | リクエスト構造エラー |
| `BATCH_LIMIT_EXCEEDED` | `Cores` 配列が20項目を超過 |
| `UNSUPPORTED_BROWSER_TYPE` | サポートされていないブラウザタイプ |
| `INVALID_VERSION` | バージョン形式エラー |
| `METADATA_LOOKUP_FAILED` | カーネルメタデータの照会に失敗 |
| `UNSUPPORTED_VERSION` | カーネルバージョンが存在しないか、このプラットフォームではサポートされていません |
| `CLIENT_NOT_READY` | クライアント未準備 |
| `SDK_NOT_READY` | SDK未初期化 |
| `INSUFFICIENT_DISK_SPACE` | ディスク容量不足 |
| `DOWNLOAD_FAILED` | ダウンロード失敗 |
| `CHECKSUM_MISMATCH` | MD5チェックサム検証失敗 |
| `EXTRACTION_FAILED` | 解凍またはインストール失敗 |
| `TIMEOUT` | 操作タイムアウト |
| `UNKNOWN` | 不明なエラー |

Endpoint: POST /api/env/core/download
Version: 2026-09-05

## Description:

  - `重複リクエストの処理` ()
    - 同一リクエスト内で同じブラウザタイプとメジャーバージョンが複数回出現した場合、検索とダウンロードは1回のみ実行されますが、各エントリにはそれぞれの結果が返されます。
- 同じバージョンへの同時リクエストは、新しいダウンロードを開始する代わりに進行中のタスクに参加します。
- リクエストされたバージョンが最新のマイナーバージョンで既にインストールされている場合、ステータスは
`already_installed`
 になります。
- 古いマイナーバージョンがインストールされている場合、利用可能な最新のマイナーバージョンに更新されます。

  - `エラーコードリファレンス` ()
    | errorCode | 説明 |
|  --- | --- |
| `INVALID_JSON` | JSON形式エラー |
| `INVALID_REQUEST` | リクエスト構造エラー |
| `BATCH_LIMIT_EXCEEDED` | `Cores` 配列が20項目を超過 |
| `UNSUPPORTED_BROWSER_TYPE` | サポートされていないブラウザタイプ |
| `INVALID_VERSION` | バージョン形式エラー |
| `METADATA_LOOKUP_FAILED` | カーネルメタデータの照会に失敗 |
| `UNSUPPORTED_VERSION` | カーネルバージョンが存在しないか、このプラットフォームではサポートされていません |
| `CLIENT_NOT_READY` | クライアント未準備 |
| `SDK_NOT_READY` | SDK未初期化 |
| `INSUFFICIENT_DISK_SPACE` | ディスク容量不足 |
| `DOWNLOAD_FAILED` | ダウンロード失敗 |
| `CHECKSUM_MISMATCH` | MD5チェックサム検証失敗 |
| `EXTRACTION_FAILED` | 解凍またはインストール失敗 |
| `TIMEOUT` | 操作タイムアウト |
| `UNKNOWN` | 不明なエラー |

## Request fields (application/json):

  - `Cores` (array, required)
    ダウンロードするカーネルのリスト（1〜20項目）

  - `Cores.BrowserType` (integer, required)
    ブラウザタイプ。`1`：Chrome、`2`：Firefox

  - `Cores.Version` (string, required)
    カーネルメジャーバージョン番号（例：`"124"`、`"146"`）

## Response 200:

  - `200` (unknown)
    成功。`data` は `total`、`succeeded`、`failed`、`results` のフィールドを持つオブジェクトです。

## Response 200 fields (application/json):

  - `code` (integer, required)
    レスポンスコード。`0`：全て成功；`-1`：部分成功；`-2`：全て失敗

  - `msg` (string | null)
    リクエストレベルのエラーメッセージ；成功時は通常 `null`

  - `data` (object, required)

  - `data.total` (integer, required)
    リクエストされたタスクの合計数

  - `data.succeeded` (integer, required)
    成功したタスク数（既にインストール済みを含む）

  - `data.failed` (integer, required)
    失敗したタスク数

  - `data.results` (array, required)
    各入力項目の実行結果（リクエストと同じ順序）

  - `data.results.index` (integer)
    `Cores` 配列内の対応するインデックス（0始まり）

  - `data.results.browserType` (integer | null)
    ブラウザタイプ

  - `data.results.requestedVersion` (string | null)
    リクエストされたメジャーバージョン

  - `data.results.resolvedVersion` (string)
    実際に解決された完全バージョン；成功時またはメタデータ解決時に返される

  - `data.results.status` (string)
    タスクステータス：`installed`、`already_installed`、または `failed`

  - `data.results.source` (string)
    ダウンロードソース：`downloaded`、`already_installed`、または `joined_in_flight`

  - `data.results.errorCode` (string)
    失敗時に返される安定したエラー分類コード

  - `data.results.serverCode` (integer)
    オプション。プラットフォームサービスから返される元のビジネスエラーコード

  - `data.results.msg` (string)
    表示メッセージ；クライアント言語によって異なる場合があります。プログラムによる結果判定には使用しないでください

  - `requestId` (string)
    リクエストの一意な識別子。サポートへの問い合わせ時に提示してください

