> For the complete documentation index, see [llms.txt](https://emify.gitbook.io/emify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://emify.gitbook.io/emify/como-empezar/errores-generales.md).

# Errores generales

### 📌 **Errores Frecuentes**

Nuestra API devuelve códigos de error estándar para facilitar la identificación y resolución de problemas. A continuación, se detallan los errores más comunes, sus posibles causas y cómo solucionarlos.

***

#### 🔹 **Listado de Errores Comunes**

| Código | Descripción               | Causa                                                  | Solución                                                                               |
| ------ | ------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------- |
| `400`  | **Bad Request**           | La solicitud tiene parámetros incorrectos o faltantes. | Verifica que los parámetros enviados sean correctos y cumplan con el formato esperado. |
| `401`  | **Unauthorized**          | No se ha enviado un token de autenticación válido.     | Asegúrate de incluir el token en el encabezado `Authorization`.                        |
| `403`  | **Forbidden**             | El usuario no tiene permisos para acceder al recurso.  | Revisa los permisos de la cuenta o el rol asignado.                                    |
| `404`  | **Not Found**             | El recurso solicitado no existe.                       | Verifica la URL y los identificadores utilizados en la solicitud.                      |
| `429`  | **Too Many Requests**     | Se superó el límite de solicitudes permitido.          | Espera el tiempo indicado en el encabezado `Retry-After` antes de volver a intentar.   |
| `500`  | **Internal Server Error** | Error inesperado en el servidor.                       | Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte.            |

***

⚠️ **Nota:** En caso de errores inesperados o problemas con la API, revisa la documentación y los encabezados de la respuesta para obtener más detalles.
