Empecemos por el principio: ¿qué es una API? En pocas palabras, una API es la forma en que dos programas de software pueden comunicarse y compartir datos. Al igual que los humanos comparten datos a través de un lenguaje común, también lo hacen los ordenadores.
En la vida suele haber una forma correcta y otra incorrecta de hacer las cosas. El desarrollo de software no es diferente. Cuando se hace mal, un problema común que vemos con las integraciones de Rock es cómo utilizan la API de Rock (lenguaje de intercambio de datos). Por ejemplo, supongamos que desea obtener un gran número de archivos de un archivador. Podrías:
- Camina hacia el archivador.
- Abre el cajón superior.
- Recuperar un archivo.
- Cierra el armario.
- Vuelve a tu mesa.
- Coloca la carpeta en tu escritorio.
- A continuación, repite los pasos del 1 al 6 para cada archivo que necesites...
Por supuesto que no. Pero eso es justo lo que muchas integraciones hacen con Rock. En lugar de eso, sería mucho más inteligente hacer un único viaje al archivador, coger todos los archivos que quieras y volver a tu escritorio de una vez. A esto lo llamamos "agrupar las peticiones" a la API. Lo contrario puede considerarse un abuso de la API.
Suena sencillo, ¿verdad? Pues te sorprendería saber cuántas integraciones abusan de la API de esta manera. Cuando se les pregunta al respecto, los proveedores de servicios responden algo así como "Estoy usando la API que Rock proporciona". Es cierto que proporcionamos esas llamadas de búsqueda única, pero se hicieron específicamente para eso: obtener información sobre un solo "archivo". Cuando se necesitan muchos datos, hay que utilizar llamadas que devuelvan varios registros a la vez. Rock dispone de muchas de ellas, pero en ocasiones puede ser necesario crear un punto final personalizado si se necesita algo muy específico (algo que Rock también permite).
Veamos un ejemplo real. En nuestra consultoría nos encontramos con una iglesia de tamaño medio que estaba trabajando con un sistema que quería integrarse en 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 de todo el tráfico a su servidor Rock. Cada barra representa un solo día, y los colores representan una sola dirección en Internet. Su primera pregunta probablemente sería: ¿Qué es la barra azul? Debe ser la conexión a Internet de la iglesia, ¿verdad? ¿Mucho tráfico debido a todo el personal? Pues no. Eso es una integración de terceros mal escrita que es responsable del 86% de todo su tráfico a Rock. Observe que la primera barra es un domingo. ¿Cómo está afectando este tráfico al registro de los domingos? En este caso concreto, la integración obligó a la iglesia a actualizar su infraestructura de servidores para soportar la integración, un coste que no esperaban.
Esto no quiere decir que todas las integraciones sean malas. De hecho, hay muchas organizaciones que lo hacen bien. Entonces, ¿cómo distinguirlas? He aquí algunos consejos:
- Si se trata de una integración popular como la pasarela My Well o el plugin Pushpay, probablemente no haya ningún problema (en ambos casos se trata de un excelente uso de la API de Rock). Las integraciones populares han sido examinadas por muchas organizaciones, y la mayoría de los problemas potenciales habrían sido descubiertos por Spark u otros socios de Rock.
- Las integraciones realizadas por estudios más pequeños o socios de nicho deben ser evaluadas por especialistas técnicos externos con un profundo conocimiento de Rock, como Triumph u otros socios de Rock.
Cuando uno se adentra en el mundo de la tecnología, asume muchas responsabilidades para tener éxito. En Triumph estamos aquí para ayudarle a navegar por esas aguas y garantizar su éxito. Póngase en contacto con nosotros si podemos ayudarle.