Empecemos por el principio: ¿qué es una API? En pocas palabras, una API es una forma en que dos programas informáticos pueden comunicarse entre sí y compartir datos. Al igual que las personas comparten información a través de un idioma común, lo mismo ocurre con los ordenadores.
En la vida suele haber una forma correcta y otra incorrecta de hacer las cosas. El desarrollo de software no es una excepción. Cuando se hace mal, un problema habitual que observamos en las integraciones de Rock es la forma en que utilizan la API de Rock (lenguaje de intercambio de datos). Por ejemplo, imagina que quisieras sacar un gran número de archivos de un archivador. ¿Qué harías?
- Acércate al archivador.
- Abre el cajón de arriba.
- Recuperar un archivo.
- Cierra el armario.
- Vuelve a tu mesa.
- Deja el expediente sobre tu escritorio.
- ¿Entonces hay que repetir los pasos del 1 al 6 con cada archivo que necesites?
¡Por supuesto que no! Pero eso es precisamente lo que muchas integraciones le hacen a Rock. En cambio, sería mucho más sensato acercarse una sola vez al archivador, coger todos los archivos que necesites y volver a tu mesa de una vez. A esto lo llamamos «agrupar las solicitudes» a la API. Hacer lo contrario puede considerarse un uso indebido de la API.
Suena sencillo, ¿verdad? Pues te sorprendería saber cuántas integraciones hacen un uso indebido de la API de esta forma. Cuando se les pregunta al respecto, los proveedores de servicios responden algo así como: «Estoy utilizando la API que ofrece Rock». Es cierto que ofrecemos esas llamadas de consulta única, pero se diseñaron específicamente para eso: obtener información sobre un solo «archivo». Cuando necesitas muchos datos, debes utilizar llamadas que devuelvan varios registros a la vez. Rock dispone de muchas de ellas, pero en ocasiones puede que tengas que crear un punto final personalizado «a medida» si necesitas algo muy específico (lo cual Rock también permite).
Veamos un ejemplo real. En el marco de nuestro trabajo de consultoría, nos encontramos con una iglesia de tamaño medio que estaba trabajando con un sistema que quería integrarse con Rock. Este proveedor de servicios utilizaba la API de Rock para extraer los datos de Rock cada dos horas.
A continuación se muestra un gráfico con todo el tráfico dirigido a su servidor Rock. Cada barra representa un día, y los colores representan una dirección de Internet concreta. Probablemente, lo primero que te preguntarías sería: ¿qué es esa barra azul? Debe de ser la conexión a Internet de la iglesia, ¿verdad? ¿Tanto tráfico debido a todo el personal? Pues no. Se trata de una integración de terceros mal programada que representa el 86 % de todo su tráfico hacia Rock. Fíjate en que la primera barra corresponde a un domingo. ¿Cómo afecta este tráfico al registro de asistentes del domingo? En este caso concreto, la integración obligó a la iglesia a actualizar su infraestructura de servidores para poder soportarla, lo cual supone un gasto que no tenían previsto.
Esto no quiere decir que todas las integraciones sean malas. De hecho, hay muchas organizaciones que lo están haciendo bien. Entonces, ¿cómo se distingue una de otra? He aquí algunos consejos:
- Si se trata de una integración muy utilizada, como My Well Gateway o el plugin de Pushpay, probablemente no haya ningún problema (en ambos casos están haciendo un excelente trabajo al utilizar la API de Rock). Las integraciones populares han sido sometidas a un riguroso proceso de verificación por parte de numerosas organizaciones, y la mayoría de los posibles problemas ya habrían sido detectados por Spark u otros socios de Rock.
- Las integraciones realizadas por estudios más pequeños o socios especializados deben ser evaluadas por especialistas técnicos externos con un profundo conocimiento de Rock, como Triumph u otros socios de Rock.
Cuando te adentras en el mundo de la tecnología, asumes muchas responsabilidades para poder tener éxito. En Triumph estamos aquí para ayudarte a navegar por esas aguas y garantizar tu éxito. No dudes en ponerte en contacto con nosotros si podemos ayudarte.