# Códigos de erro

Esta página lista códigos de erro comuns retornados pela API MoreLogin.

## Formato de resposta

Todas as respostas da API seguem este formato padrão:

```json
{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}
```

| Campo | Tipo | Descrição |
|  --- | --- | --- |
| `code` | inteiro | `0` = sucesso, `>0` = erro |
| `msg` | corda | Mensagem de erro (nulo quando bem sucedido) |
| `data` | objeto | Dados de resposta |
| `requestId` | corda | Identificador de solicitação exclusivo para solução de problemas |


## Códigos de erro comuns

### Erros Gerais

| Código | Descrição | Solução |
|  --- | --- | --- |
| `0` | Sucesso | - |
| `99001` | Parâmetros inválidos | Verifique o formato do corpo da solicitação e os campos obrigatórios |
| `99002` | Permissão negada | Verifique as permissões da sua conta |
| `99003` | Solicitar exceção | Faça os ajustes comerciais necessários com base na resposta |
| `99004` | Corpo da solicitação muito grande | Verifique o corpo da sua solicitação |
| `429` | Limite de taxa excedido | Reduza a frequência de solicitações e tente novamente após atraso |


### Erros de perfil do navegador (API local)

| Código | Descrição | Solução |
|  --- | --- | --- |
| `100` | O perfil já está em execução | Feche o perfil primeiro com `/api/env/close` |
| `101` | Perfil não encontrado | Verifique o `envId` ou `uniqueId` |
| `102` | Cliente MoreLogin não está em execução | Inicie o aplicativo de desktop MoreLogin |
| `103` | Chave de criptografia necessária | Forneça `encryptKey` para perfis criptografados |


### Erros de telefone na nuvem (API aberta)

| Código | Descrição | Solução |
|  --- | --- | --- |
| `200` | O telefone na nuvem está off-line | Ligue o telefone na nuvem primeiro |
| `201` | Falha na instalação do aplicativo | Verifique o `appVersionId` ou `packageName` |
| `202` | Falha no upload do arquivo | Verifique o URL do arquivo e o caminho de destino |


## Códigos de status HTTP

| Estado | Descrição |
|  --- | --- |
| `200` | Solicitação processada (verifique o campo `code` para ver o resultado comercial) |
| `401` | Não autorizado – token de acesso inválido ou expirado |
| `403` | Proibido – permissões insuficientes |
| `429` | Muitas solicitações — limite de taxa excedido |
| `500` | Erro interno do servidor – entre em contato com o suporte |


> **Dica**: sempre inclua o `requestId` da resposta ao entrar em contato com o suporte para solucionar problemas mais rapidamente.