> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introducción
> La API de tipos de cambio de Cleariflow ofrece capacidades de conversión de divisas en tiempo real a través de una interfaz JSON RESTful moderna y simplificada, con soporte para más de 80 divisas globales, tipos en vivo, datos históricos y herramientas de conversión instantánea.
## Primeros pasos
El endpoint `live` proporciona acceso instantáneo a los tipos de cambio actuales entre múltiples divisas, permitiendo cálculos financieros en tiempo real y seguimiento del mercado.
El endpoint `convert` transforma importes específicos entre divisas utilizando los tipos de cambio más actualizados, ideal para aplicaciones financieras y plataformas de comercio electrónico.
El endpoint `symbols` ofrece un catálogo completo de divisas admitidas con descripciones detalladas, facilitando la selección dinámica y la validación de divisas en las aplicaciones.
### Arquitectura REST
La API de tipos de cambio sigue los principios REST, utilizando URL predecibles orientadas a recursos y códigos de estado HTTP estándar para una integración fluida y el manejo de errores.
### Seguridad HTTPS
Todas las comunicaciones de la API están protegidas mediante protocolos de cifrado TLS 1.2 o superior para garantizar la integridad y privacidad de los datos.
### Versionado de la API
La API de tipos de cambio mantiene la compatibilidad hacia atrás mediante versionado y actualmente opera en la versión 1, con mejoras futuras planificadas.
### Autenticación
Su clave API sirve como credencial exclusiva para acceder a la API de tipos de cambio. Cada servicio de Cleariflow requiere una clave única, lo que garantiza un acceso seguro y aislado entre las distintas APIs.
## Códigos de respuesta y error
Cuando las solicitudes fallan, la API devuelve respuestas de error JSON estructuradas con códigos y descripciones específicos para una resolución de problemas eficaz.
| Code | Type | Details |
| ---- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 | OK | Todo funcionó como se esperaba. |
| 204 | OK | No hay datos de ubicación para la IP enviada. |
| 400 | Bad request | Solicitud incorrecta. |
| 401 | Unauthorized | La solicitud no fue aceptable. Normalmente debido a que la clave API falta o es incorrecta. |
| 422 | Quota reached | La solicitud se abortó por créditos API insuficientes. (Planes gratuitos) |
| 429 | Too many requests | La solicitud se abortó porque se alcanzó el número de solicitudes permitidas por segundo. Esto ocurre en planes gratuitos, ya que las solicitudes están limitadas a 1 por segundo. |
| 500 | Internal server error | La solicitud no pudo completarse debido a un error en el servidor. |
| 503 | Service unavailable | El servidor no estaba disponible. |