Qué es una API
Una interfaz de programación de aplicaciones establece cómo un sistema puede solicitar datos o ejecutar operaciones en otro. Describe recursos, entradas, respuestas y condiciones de acceso. En prevención puede conectar procesos que hoy dependen de intercambiar archivos, pero la existencia de una API no significa que todas las funciones de un producto estén disponibles por esa vía.
Definir primero el intercambio
Conviene concretar qué dato se necesita, qué sistema lo mantiene y en qué dirección viaja. Una alta de persona, un cambio de centro y el estado de una acción tienen reglas diferentes. La integración del software de SST con otros sistemas requiere resolver identificadores, fechas y responsabilidades, además de la conexión técnica.
Permisos para cada operación
Autenticar a la aplicación que llama no basta para autorizar cualquier consulta. Los permisos deben limitar recursos, operaciones y ámbito organizativo. Las exportaciones y los datos sanitarios exigen especial atención. Las credenciales se protegen y se retiran cuando dejan de ser necesarias; no se insertan en documentos públicos ni se comparten como si fueran enlaces de consulta.
Errores, límites y cambios
La integración debe interpretar respuestas de error, límites de uso y tiempos de espera. Repetir una operación que crea un registro puede duplicarlo si no se ha diseñado el tratamiento de reintentos. También se acuerda cómo evolucionan las versiones y qué aviso existe antes de retirar un campo. Una documentación accesible debe mantenerse coherente con el comportamiento real.
Ejemplo de aceptación
En un ejemplo hipotético, recursos humanos comunica cambios de centro al sistema preventivo. La prueba incluye un cambio normal, una persona desconocida, un mensaje repetido y una interrupción de la conexión. Se verifica que el resultado quede en el centro correcto y que los fallos puedan detectarse y corregirse sin generar perfiles duplicados.
Qué preguntar al proveedor
Resulta útil pedir documentación de las operaciones concretas, entorno de pruebas, permisos, cuotas y soporte. El criterio de aceptación debe describir resultados de negocio y no solo una respuesta técnica correcta. La disponibilidad de API y sus condiciones se comprueban para cada producto y contrato; este concepto no presupone capacidades de una plataforma determinada.
