# Formato de respuesta común

Todas las respuestas de la API MoreLogin siguen un formato JSON estándar.

## Estructura de respuesta

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

| campo | Tipo | Descripción |
|  --- | --- | --- |
| CODIGO_PH_0 | CODIGO_PH_0 | Código de resultado. `0` = éxito, otros valores indican errores |
| CODIGO_PH_0 | `cadena| nulo` | Mensaje de error. `null` cuando tiene éxito |
| CODIGO_PH_0 | `objeto| matriz | nulo` | Carga útil de respuesta. La estructura varía según el punto final |
| CODIGO_PH_0 | CODIGO_PH_0 | Identificador de solicitud único. Incluya esto cuando se comunique con el soporte |


## Respuesta exitosa

```json
{
  "code": 0,
  "msg": null,
  "data": {
    "id": 1234567890
  },
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

## Respuesta de error

```json
{
  "code": 99001,
  "msg": "Invalid parameters",
  "data": null,
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

## Respuestas paginadas

Los puntos finales de lista devuelven datos paginados en este formato:

```json
{
  "code": 0,
  "msg": null,
  "data": {
    "total": 100,
    "current": 1,
    "pages": 10,
    "dataList": [
      { ... },
      { ... }
    ]
  },
  "requestId": "..."
}
```

| campo | Descripción |
|  --- | --- |
| CODIGO_PH_0 | Número total de registros |
| CODIGO_PH_0 | Número de página actual |
| CODIGO_PH_0 | Número total de páginas |
| CODIGO_PH_0 | Matriz de registros para la página actual |


## Códigos de estado HTTP

| Estado | Descripción |
|  --- | --- |
| CODIGO_PH_0 | Solicitud procesada exitosamente (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**: Siempre verifique el campo `code` en el cuerpo de la respuesta, no solo el código de estado HTTP. Un estado HTTP `200` con `code: 99001` significa que la solicitud se recibió pero no se pudo realizar la validación.