Què és una API
Una interfície de programació d’aplicacions estableix com un sistema pot sol·licitar dades o executar operacions en un altre. Descriu recursos, entrades, respostes i condicions d’accés. En prevenció pot connectar processos que avui depenen d’intercanviar arxius, però l’existència d’una API no significa que totes les funcions d’un producte estiguin disponibles per aquesta via.
Definir primer l’intercanvi
Convé concretar quina dada es necessita, quin sistema ho manté i en quina direcció viatja. Una alta de persona, un canvi de centre i l’estat d’una acció tenen regles diferents. La integració del programari de SST amb altres sistemes requereix resoldre identificadors, dates i responsabilitats, a més de la connexió tècnica.
Permisos per a cada operació
Autenticar a l’aplicació que anomena no basta per a autoritzar qualsevol consulta. Els permisos han de limitar recursos, operacions i àmbit organitzatiu. Les exportacions i les dades sanitàries exigeixen especial atenció. Les credencials es protegeixen i es retiren quan deixen de ser necessàries; no s’insereixen en documents públics ni es comparteixen com si fossin enllaços de consulta.
Errors, límits i canvis
La integració ha d’interpretar respostes d’error, límits d’ús i temps d’espera. Repetir una operació que crea un registre pot duplicar-lo si no s’ha dissenyat el tractament de reintents. També s’acorda com evolucionen les versions i quin avís existeix abans de retirar un camp. Una documentació accessible ha de mantenir-se coherent amb el comportament real.
Exemple d’acceptació
En un exemple hipotètic, recursos humans comunica canvis de centre al sistema preventiu. La prova inclou un canvi normal, una persona desconeguda, un missatge repetit i una interrupció de la connexió. Es verifica que el resultat quedi en el centre correcte i que les fallades puguin detectar-se i corregir-se sense generar perfils duplicats.
Què preguntar al proveïdor
Resulta útil demanar documentació de les operacions concretes, entorn de proves, permisos, quotes i suport. El criteri d’acceptació ha de descriure resultats de negoci i no sols una resposta tècnica correcta. La disponibilitat de API i les seves condicions es comproven per a cada producte i contracte; aquest concepte no pressuposa capacitats d’una plataforma determinada.
