Primeros pasos
Validación de IBAN
El endpoint
iban valida números de cuenta bancaria internacional (IBAN) con validación exhaustiva específica por país, comprobación de formato e información estructural detallada para aplicaciones financieras.Validación de BIC
El endpoint
bic valida códigos de identificación bancaria (BIC), proporcionando un desglose detallado de códigos bancarios, información del país y tipos de institución para operaciones bancarias internacionales.Países admitidos
Lista completa de países admitidos para la validación de IBAN y BIC, incluidos códigos de país, información de moneda y requisitos de formato específicos.
Arquitectura REST
La API de validación bancaria 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 validación bancaria 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 validación bancaria. 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. |
| 400 | Bad request | Solicitud incorrecta: parámetros faltantes o no válidos. |
| 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. |