Primeros pasos
Tipos de cambio en vivo
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.Conversión de tipos de cambio
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.Símbolos de divisas disponibles
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. |