# Baixar núcleo do navegador

Baixar e instalar núcleo(s) do navegador. Suporta download em lote de até 20 núcleos por solicitação. O tempo limite para esta operação pode ser de até aproximadamente 30 minutos; os chamadores devem configurar seu tempo limite para mais de 1805 segundos.
Requer versão do cliente MoreLogin **2.61.1** ou superior.
### Tratamento de solicitações duplicadas
- Se o mesmo tipo de navegador e versão principal aparecer várias vezes em uma única solicitação, apenas uma consulta e download será realizada, mas cada entrada receberá seu próprio resultado.
- Solicitações concorrentes para a mesma versão se juntarão à tarefa em andamento em vez de iniciar um novo download.
- Se a versão solicitada já estiver instalada com a versão secundária mais recente, o status será
`already_installed`
.
- Se uma versão secundária mais antiga estiver instalada, será atualizada para a versão secundária mais recente disponível.

### Referência de códigos de erro
| errorCode | Descrição |
|  --- | --- |
| `INVALID_JSON` | Corpo JSON malformado |
| `INVALID_REQUEST` | Estrutura de solicitação inválida |
| `BATCH_LIMIT_EXCEEDED` | O array `Cores` excede 20 itens |
| `UNSUPPORTED_BROWSER_TYPE` | Tipo de navegador não suportado |
| `INVALID_VERSION` | Formato de versão inválido |
| `METADATA_LOOKUP_FAILED` | Falha ao consultar metadados do núcleo |
| `UNSUPPORTED_VERSION` | Versão do núcleo não existe ou não é suportada nesta plataforma |
| `CLIENT_NOT_READY` | Cliente não pronto |
| `SDK_NOT_READY` | SDK não inicializado |
| `INSUFFICIENT_DISK_SPACE` | Espaço em disco insuficiente |
| `DOWNLOAD_FAILED` | Download falhou |
| `CHECKSUM_MISMATCH` | Verificação de checksum MD5 falhou |
| `EXTRACTION_FAILED` | Extração ou instalação falhou |
| `TIMEOUT` | Tempo limite da operação excedido |
| `UNKNOWN` | Erro desconhecido |

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

## Description:

  - `Tratamento de solicitações duplicadas` ()
    - Se o mesmo tipo de navegador e versão principal aparecer várias vezes em uma única solicitação, apenas uma consulta e download será realizada, mas cada entrada receberá seu próprio resultado.
- Solicitações concorrentes para a mesma versão se juntarão à tarefa em andamento em vez de iniciar um novo download.
- Se a versão solicitada já estiver instalada com a versão secundária mais recente, o status será
`already_installed`
.
- Se uma versão secundária mais antiga estiver instalada, será atualizada para a versão secundária mais recente disponível.

  - `Referência de códigos de erro` ()
    | errorCode | Descrição |
|  --- | --- |
| `INVALID_JSON` | Corpo JSON malformado |
| `INVALID_REQUEST` | Estrutura de solicitação inválida |
| `BATCH_LIMIT_EXCEEDED` | O array `Cores` excede 20 itens |
| `UNSUPPORTED_BROWSER_TYPE` | Tipo de navegador não suportado |
| `INVALID_VERSION` | Formato de versão inválido |
| `METADATA_LOOKUP_FAILED` | Falha ao consultar metadados do núcleo |
| `UNSUPPORTED_VERSION` | Versão do núcleo não existe ou não é suportada nesta plataforma |
| `CLIENT_NOT_READY` | Cliente não pronto |
| `SDK_NOT_READY` | SDK não inicializado |
| `INSUFFICIENT_DISK_SPACE` | Espaço em disco insuficiente |
| `DOWNLOAD_FAILED` | Download falhou |
| `CHECKSUM_MISMATCH` | Verificação de checksum MD5 falhou |
| `EXTRACTION_FAILED` | Extração ou instalação falhou |
| `TIMEOUT` | Tempo limite da operação excedido |
| `UNKNOWN` | Erro desconhecido |

## Request fields (application/json):

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

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

  - `Cores.Version` (string, required)
    Número da versão principal do núcleo, ex. `"124"`, `"146"`

## Response 200:

  - `200` (unknown)
    Sucesso. `data` é um objeto com os campos `total`, `succeeded`, `failed` e `results`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resposta. `0`:todos bem-sucedidos; `-1`:sucesso parcial; `-2`:todos falharam

  - `msg` (string | null)
    Mensagem de erro no nível da solicitação; normalmente `null` em caso de sucesso

  - `data` (object, required)

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

  - `data.succeeded` (integer, required)
    Número de tarefas bem-sucedidas (incluindo já instaladas)

  - `data.failed` (integer, required)
    Número de tarefas que falharam

  - `data.results` (array, required)
    Resultado da execução para cada item de entrada, na mesma ordem da solicitação

  - `data.results.index` (integer)
    Índice correspondente no array `Cores` (baseado em 0)

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

  - `data.results.requestedVersion` (string | null)
    A versão principal solicitada

  - `data.results.resolvedVersion` (string)
    A versão completa real resolvida; retornada em caso de sucesso ou quando os metadados são resolvidos

  - `data.results.status` (string)
    Status da tarefa:`installed`, `already_installed` ou `failed`

  - `data.results.source` (string)
    Fonte de download:`downloaded`, `already_installed` ou `joined_in_flight`

  - `data.results.errorCode` (string)
    Código de classificação de erro estável retornado em caso de falha

  - `data.results.serverCode` (integer)
    Opcional. Código de erro de negócio original do serviço da plataforma

  - `data.results.msg` (string)
    Mensagem de exibição; pode variar conforme o idioma do cliente. Não usar para verificação programática de resultados

  - `requestId` (string)
    Identificador único da solicitação; informe-o ao contatar o suporte

