# Códigos de error

Esta página enumera códigos de error comunes devueltos por la API MoreLogin.

## Formato de respuesta

Todas las respuestas de API siguen este formato estándar:

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

| campo | Tipo | Descripción |
|  --- | --- | --- |
| CODIGO_PH_0 | entero | `0` = éxito, `>0` = error |
| CODIGO_PH_0 | cuerda | Mensaje de error (nulo cuando tiene éxito) |
| CODIGO_PH_0 | objeto | Datos de respuesta |
| CODIGO_PH_0 | cuerda | Identificador de solicitud único para solución de problemas |


## Códigos de error comunes

### Errores generales

| Código | Descripción | Solución |
|  --- | --- | --- |
| CODIGO_PH_0 | Éxito | — |
| CODIGO_PH_0 | Parámetros no válidos | Verifique el formato del cuerpo de la solicitud y los campos obligatorios |
| CODIGO_PH_0 | Permiso denegado | Verifique los permisos de su cuenta |
| CODIGO_PH_0 | Solicitar excepción | Realice los ajustes comerciales necesarios según la respuesta. |
| CODIGO_PH_0 | El cuerpo de la solicitud es demasiado grande | Revisa el cuerpo de tu solicitud |
| CODIGO_PH_0 | Límite de tarifa excedido | Reduzca la frecuencia de las solicitudes y vuelva a intentarlo después del retraso |


### Errores de perfil del navegador (API local)

| Código | Descripción | Solución |
|  --- | --- | --- |
| CODIGO_PH_0 | El perfil ya se está ejecutando | Cierra el perfil primero con `/api/env/close` |
| CODIGO_PH_0 | Perfil no encontrado | Verifique el `envId` o `uniqueId` |
| CODIGO_PH_0 | El cliente MoreLogin no se está ejecutando | Inicie la aplicación de escritorio MoreLogin |
| CODIGO_PH_0 | Se requiere clave de cifrado | Proporcione `encryptKey` para perfiles cifrados |


### Errores del teléfono en la nube (API abierta)

| Código | Descripción | Solución |
|  --- | --- | --- |
| CODIGO_PH_0 | El teléfono en la nube está desconectado | Primero encienda el teléfono en la nube |
| CODIGO_PH_0 | La instalación de la aplicación falló | Verifique el `appVersionId` o `packageName` |
| CODIGO_PH_0 | Error al subir el archivo | Verificar la URL del archivo y la ruta de destino |


## Códigos de estado HTTP

| Estado | Descripción |
|  --- | --- |
| CODIGO_PH_0 | Solicitud procesada (verifique el campo `code` para ver el resultado comercial) |
| CODIGO_PH_0 | No autorizado: token de acceso no válido o caducado |
| CODIGO_PH_0 | Prohibido: permisos insuficientes |
| CODIGO_PH_0 | Demasiadas solicitudes: se superó el límite de tarifa |
| CODIGO_PH_0 | Error interno del servidor: póngase en contacto con el soporte técnico |


> **Consejo**: Incluya siempre el `requestId` de la respuesta cuando se comunique con el soporte para una solución de problemas más rápida.