# Descargar núcleo del navegador

Descargar e instalar núcleo(s) del navegador. Admite la descarga por lotes de hasta 20 núcleos por solicitud. El tiempo de espera para esta operación puede ser de hasta aproximadamente 30 minutos; los llamadores deben configurar su tiempo de espera en más de 1805 segundos.
Requiere la versión del cliente MoreLogin **2.61.1** o superior.
### Manejo de solicitudes duplicadas
- Si el mismo tipo de navegador y versión principal aparece varias veces en una sola solicitud, solo se realiza una búsqueda y descarga, pero cada entrada obtiene su propio resultado.
- Las solicitudes concurrentes para la misma versión se unirán a la tarea en curso en lugar de iniciar una nueva descarga.
- Si la versión solicitada ya está instalada con la última versión menor, el estado será
`already_installed`
.
- Si se instala una versión menor anterior, se actualizará a la última versión menor disponible.

### Referencia de códigos de error
| errorCode | Descripción |
|  --- | --- |
| `INVALID_JSON` | Cuerpo JSON con formato incorrecto |
| `INVALID_REQUEST` | Estructura de solicitud no válida |
| `BATCH_LIMIT_EXCEEDED` | El array `Cores` supera los 20 elementos |
| `UNSUPPORTED_BROWSER_TYPE` | Tipo de navegador no compatible |
| `INVALID_VERSION` | Formato de versión no válido |
| `METADATA_LOOKUP_FAILED` | Error al consultar los metadatos del núcleo |
| `UNSUPPORTED_VERSION` | La versión del núcleo no existe o no es compatible con esta plataforma |
| `CLIENT_NOT_READY` | Cliente no listo |
| `SDK_NOT_READY` | SDK no inicializado |
| `INSUFFICIENT_DISK_SPACE` | Espacio en disco insuficiente |
| `DOWNLOAD_FAILED` | Descarga fallida |
| `CHECKSUM_MISMATCH` | Verificación de suma de comprobación MD5 fallida |
| `EXTRACTION_FAILED` | Extracción o instalación fallida |
| `TIMEOUT` | Tiempo de operación agotado |
| `UNKNOWN` | Error desconocido |

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

## Description:

  - `Manejo de solicitudes duplicadas` ()
    - Si el mismo tipo de navegador y versión principal aparece varias veces en una sola solicitud, solo se realiza una búsqueda y descarga, pero cada entrada obtiene su propio resultado.
- Las solicitudes concurrentes para la misma versión se unirán a la tarea en curso en lugar de iniciar una nueva descarga.
- Si la versión solicitada ya está instalada con la última versión menor, el estado será
`already_installed`
.
- Si se instala una versión menor anterior, se actualizará a la última versión menor disponible.

  - `Referencia de códigos de error` ()
    | errorCode | Descripción |
|  --- | --- |
| `INVALID_JSON` | Cuerpo JSON con formato incorrecto |
| `INVALID_REQUEST` | Estructura de solicitud no válida |
| `BATCH_LIMIT_EXCEEDED` | El array `Cores` supera los 20 elementos |
| `UNSUPPORTED_BROWSER_TYPE` | Tipo de navegador no compatible |
| `INVALID_VERSION` | Formato de versión no válido |
| `METADATA_LOOKUP_FAILED` | Error al consultar los metadatos del núcleo |
| `UNSUPPORTED_VERSION` | La versión del núcleo no existe o no es compatible con esta plataforma |
| `CLIENT_NOT_READY` | Cliente no listo |
| `SDK_NOT_READY` | SDK no inicializado |
| `INSUFFICIENT_DISK_SPACE` | Espacio en disco insuficiente |
| `DOWNLOAD_FAILED` | Descarga fallida |
| `CHECKSUM_MISMATCH` | Verificación de suma de comprobación MD5 fallida |
| `EXTRACTION_FAILED` | Extracción o instalación fallida |
| `TIMEOUT` | Tiempo de operación agotado |
| `UNKNOWN` | Error desconocido |

## Request fields (application/json):

  - `Cores` (array, required)
    Lista de núcleos para descargar (1–20 elementos)

  - `Cores.BrowserType` (integer, required)
    Tipo de navegador. `1`:Chrome, `2`:Firefox

  - `Cores.Version` (string, required)
    Número de versión principal del núcleo, p. ej. `"124"`, `"146"`

## Response 200:

  - `200` (unknown)
    Correcto. `data` es un objeto con los campos `total`, `succeeded`, `failed` y `results`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de respuesta. `0`:todos exitosos; `-1`:éxito parcial; `-2`:todos fallidos

  - `msg` (string | null)
    Mensaje de error a nivel de solicitud; normalmente `null` en caso de éxito

  - `data` (object, required)

  - `data.total` (integer, required)
    Número total de tareas solicitadas

  - `data.succeeded` (integer, required)
    Número de tareas exitosas (incluyendo las ya instaladas)

  - `data.failed` (integer, required)
    Número de tareas fallidas

  - `data.results` (array, required)
    Resultado de ejecución para cada elemento de entrada, en el mismo orden que la solicitud

  - `data.results.index` (integer)
    Índice correspondiente en el array `Cores` (basado en 0)

  - `data.results.browserType` (integer | null)
    Tipo de navegador

  - `data.results.requestedVersion` (string | null)
    La versión principal solicitada

  - `data.results.resolvedVersion` (string)
    La versión completa real resuelta; se devuelve en caso de éxito o cuando se resuelven los metadatos

  - `data.results.status` (string)
    Estado de la tarea:`installed`, `already_installed` o `failed`

  - `data.results.source` (string)
    Fuente de descarga:`downloaded`, `already_installed` o `joined_in_flight`

  - `data.results.errorCode` (string)
    Código de clasificación de error estable devuelto en caso de fallo

  - `data.results.serverCode` (integer)
    Opcional. Código de error de negocio original del servicio de la plataforma

  - `data.results.msg` (string)
    Mensaje de visualización; puede variar según el idioma del cliente. No usar para verificación programática de resultados

  - `requestId` (string)
    Identificador único de la solicitud; indíquelo al contactar con soporte

