El lugar de las API en una especificación

Integrar una o varias API de sistemas de terceros es inevitable cuando se desarrolla un producto digital. Independientemente del tipo de proyecto y de su complejidad, es imprescindible. Como empresa emergente, tienes que pensar en la categoría de API que vas a necesitar y, por supuesto, expresarlo con claridad. ¡ Le Backyard levanta el velo sobre las API y su importancia en una especificación!

I. API: una realidad ineludible para todos los proyectos digitales

Casi ningún proyecto digital parte de cero. Por eso, las API de terceros son herramientas esenciales a la hora de desarrollar aplicaciones móviles, sitios web o cualquier otro producto digital.

1. ¿Qué es una API?

Una API (Interfaz de Programación de Aplicaciones) es una interfaz de software que actúa como intermediaria para permitir que dos aplicaciones diferentes se comuniquen sin conocer los detalles de sus respectivas implementaciones. El objetivo es poder intercambiar datos o servicios entre ellas.

Existen diferentes categorías de API: 

• API públicas accesibles para todos;
• API privadas reservadas a un determinado número de usuarios;
• API de socios accesibles sólo a socios específicos sujetos a la firma de un contrato.

En todos los casos, a la hora de desarrollar su producto, lo más fácil es utilizar un servicio de terceros para beneficiarse de su API. Crear una tú mismo desde cero es un reto largo y costoso. 

2. ¿Cuáles son los diferentes tipos de API?

Existen varios tipos de API que facilitan el funcionamiento del producto digital que desea desarrollar. He aquí algunos ejemplos: 

• API cartográficas: útiles, en particular, para introducir una dirección postal o mostrar una ubicación en un mapa. Las API de Google son las más utilizadas. 
• APIs de pago: incluyen APIs tanto de bancos tradicionales como de otros sistemas privados, como Stripe.
• API de notificación: pueden ser notificaciones por correo electrónico o SMS. Brevo es un ejemplo de API que ofrece este servicio.
• Las API de notificaciones push móviles se utilizan para notificar a los usuarios dentro de una aplicación. Firebase es el servicio de terceros elegido.
• APIs de vídeo: permiten crear flujos de vídeo, muy útiles para aplicaciones de teleconsulta, por ejemplo, que tienen importantes necesidades de vídeo.
• Las API de chat permiten chatear en tiempo real y también enviar imágenes o vídeos. CometChat se utiliza habitualmente para esta función.
• APIs de verificación de identidad, que son extremadamente importantes para las aplicaciones bancarias en particular. Se trata de las API KYC o KYB.

‍

II. Previsión de costes

Por supuesto, integrar APIs en tu aplicación móvil o sitio web tiene un coste. Por eso es importante anticipar en el pliego de condiciones las necesidades del producto en términos de API, para evitar sorpresas desagradables.

1. La integración no es necesariamente gratuita

Una API es algo así como un servicio prestado por proveedores de servicios, y a los proveedores de servicios hay que pagarles. Lógicamente, la inmensa mayoría de las API, como las de Google o Stripe, son de pago: a veces desde el principio, a menudo mediante pago por uso.

Para definir el presupuesto necesario, primero es importante distinguir entre los dos costes siguientes:

• El coste de la integración: una inversión inicial (generalmente de una sola vez) para conectar la API al sistema.
  
  
• Costes de explotación: costes recurrentes vinculados al uso real de la API.

2. Comprender los modelos de negocio de las API

No todas las API funcionan con el mismo modelo de negocio. Por eso es importante investigar antes para elegir e incluir información sobre los costes en el pliego de condiciones.

Los proveedores de API adoptan diversos modelos que pueden adaptarse más o menos a sus necesidades:

• Crédito inicial gratuito, seguido de precios por volumen (número de llamadas, ancho de banda, etc.).
• Suscripciones mensuales o modelos basados en comisiones. Es el caso de Stripe, por ejemplo, que cobra 0,25 € + un porcentaje por transacción.
• A veces, las listas de precios no están disponibles en Internet. Por eso, las empresas de nueva creación se ven obligadas a firmar un contrato directo con el proveedor para conocer los costes reales.

3. Otra opción es desarrollar la API internamente

En Le Backyard, le aconsejamos que utilice API de terceros que ya estén maduras, sean eficaces de inmediato y fáciles de implementar, en lugar de diseñar una API usted mismo. Crear una API desde cero suele ser un reto largo y costoso.

Sin embargo, algunas empresas emergentes prefieren evitar las API de terceros por motivos de soberanía de datos o cumplimiento de la normativa.

Este enfoque ofrece una serie de ventajas, como la independencia de terceros proveedores de servicios y el control total de la lógica empresarial.

Sin embargo, el coste de desarrollo inicial es considerable, lo que se traduce en un alto grado de inversión por parte de la empresa. Además, existen requisitos de mantenimiento continuo que no deben subestimarse, y problemas de escalabilidad que deben preverse desde la fase de diseño.

Gracias a su experiencia y a sus conocimientos constantemente actualizados, Le Backyard puede ofrecer a sus clientes la creación de su propia API.

III. La importancia de añadir un componente API al pliego de condiciones

Un proyecto en el que intervienen API de terceros no puede improvisarse. Para evitar sorpresas desagradables, el pliego de condiciones debe incluir elementos precisos, tanto técnicos como estratégicos.

1. Una lista clara de las API previstas

Para cada función, es esencialidentificar de antemano los servicios de terceros previstos o planificados. Esto le permitirá :

• mapear las dependencias desde el principio ;
• alinear a las partes interesadas con las opciones tecnológicas ;
• anticipar costes y limitaciones.

Aunque algunas integraciones estén aún en estudio, mencionarlas da visibilidad al proveedor de servicios, que será el encargado de ponerlas en práctica, y evita las zonas grises. Así que sé exhaustivo, aunque tengas dudas.

2. Proporcionar documentación técnica

Para que los proveedores de servicios comprendan bien las API que desea utilizar, es importante adjuntar o proporcionar enlaces a la documentación técnica de las API en cuestión. 

Esto ahorra un tiempo precioso, facilita la estimación de los plazos de integración, la identificación de posibles cuellos de botella y la preparación de una arquitectura técnica coherente.

Aunque Le Backyard ha integrado decenas de API desde su creación, hay muchas con las que no estamos familiarizados, porque son nuevas o están muy anidadas. Una buena documentación es, por tanto, esencial para que podamos hacer las preguntas adecuadas y calibrar nuestra intervención.

3. Evaluar las dependencias jurídicas

Esto puede no parecer evidente a primera vista, pero las API también responden a limitaciones contractuales o de libertad de uso. Por eso es esencial tener en cuenta este punto a la hora de elaborar las especificaciones.

En particular, hay que identificar las obligaciones legales asociadas al uso de cada servicio (almacenamiento de datos, cumplimiento del RGPD, licencias, etc.) y anticipar los riesgos en caso de cambio de API: costes técnicos, revisión de la arquitectura, interrupción temporal del servicio, etc.

4. No olvide la importancia de la pila técnica

La elección de la pila técnica determina en gran medida la facilidad de integración de determinadas API. No todas las API son compatibles con todas las tecnologías.

Algunas pilas ofrecen SDK, bibliotecas o plugins listos para usar para servicios comunes (pago, cartografía, notificaciones, etc.), mientras que otras requieren un trabajo de integración mucho más amplio.

Anticipar posibles compatibilidades o complejidades en la fase de redacción de las especificaciones es, por tanto, esencial para ahorrar tiempo durante el desarrollo y tomar las mejores decisiones.

Aunque las especificaciones y la información sobre la API que contienen son extremadamente útiles para la agencia que trabaja con la start-up en el desarrollo de la aplicación móvil o el sitio web, no fijan en piedra la relación proveedor de servicios-cliente.

De hecho, una buena agencia de desarrollo también hará su propio trabajo de investigación para asegurarse de que las peticiones de la start-up son beneficiosas para el desarrollo del servicio.

Aquí es donde la agencia desempeña un papel clave de asesoramiento, ayudando a la start-up a tomar las decisiones correctas. Si está pensando en desarrollar un producto digital, Le Backyard puede ayudarle. No dudes en rellenar nuestro formulario de contacto para contarnos más cosas.