API

Una API (sigla de "Application Programming Interface", o interfaz de programación de aplicaciones) es un conjunto de reglas que permite que dos programas se comuniquen entre sí sin tener que conocer cómo está construido el otro por dentro. Funciona como un contrato: el sistema que ofrece la API publica qué pedidos acepta y qué respuestas devuelve, y cualquier otro sistema puede consumirla siguiendo ese contrato.

La analogía clásica es la del mozo en un restaurante: vos no entrás a la cocina ni sabés cómo se prepara cada plato, le pedís al mozo desde la carta y él te trae el resultado. La API es ese intermediario: traduce tu pedido, lo lleva al sistema correcto y te devuelve la respuesta en un formato previsible. Por eso es la pieza base de cualquier integración entre aplicaciones modernas.

En el mundo Salesforce, las APIs son lo que permite que la plataforma converse con tu ERP, tu e-commerce, WhatsApp o un sistema de facturación, en vez de quedar como una isla de datos. Conectar esos sistemas vía API es parte del trabajo de implementación que aborda Salesforce, donde la integración limpia entre plataformas evita la doble carga de datos y las planillas intermedias.

Cómo funciona una API en la práctica

Una API expone un conjunto de endpoints (direcciones a las que se les hace un pedido) y, para cada uno, define el método, los parámetros de entrada y el formato de la respuesta. La mayoría de las APIs de negocio hoy son REST: viajan sobre HTTP, usan verbos como GET (leer), POST (crear), PUT/PATCH (actualizar) y DELETE (borrar), y devuelven los datos en JSON. El sistema que pide se llama cliente y el que responde, servidor; entre ambos solo circula el contrato, nunca el código interno.

Un ejemplo concreto en Argentina: una empresa de Consumo Masivo toma pedidos por su tienda online y necesita que cada venta aparezca como una Oportunidad en su CRM y dispare la facturación electrónica en AFIP. En lugar de que un empleado copie datos a mano tres veces, la tienda llama por API al CRM para crear el registro, y el CRM llama por API al sistema fiscal para emitir el comprobante. Todo ocurre en segundos y sin intervención humana. Ese encadenamiento de llamadas es lo que sostiene la idea de una única fuente de verdad: el dato se carga una vez y fluye solo.

Por qué importa para el negocio

Una API bien diseñada es la diferencia entre sistemas que conversan y sistemas que viven aislados. Sus beneficios concretos:

• Elimina la doble carga: los datos pasan de un sistema a otro sin reescribirse, lo que reduce errores y horas de trabajo manual.
• Habilita la automatización: sin API no hay forma de que un proceso dispare otro entre plataformas distintas (por ejemplo, que un pago confirmado actualice el stock).
• Permite escalar sin rehacer todo: podés sumar una herramienta nueva conectándola al ecosistema existente en vez de migrar todo a un solo software.
• Da control de acceso: la API expone solo lo necesario y exige autenticación, así que terceros usan tus datos sin ver tu base completa.

La autenticación suele resolverse con claves de API (un token secreto que identifica a quien llama) o, en escenarios más seguros, con OAuth, que delega el permiso sin compartir contraseñas. Y para no saturar el servidor, casi todas aplican rate limiting: un límite de cuántas llamadas se aceptan por minuto.

API vs Webhook: dos formas de comunicar sistemas

Es la confusión más común. Una API tradicional funciona por consulta: tu sistema pregunta ("¿hay pedidos nuevos?") y el otro responde. Un webhook invierte la lógica: el sistema avisa solo cuando algo pasa, sin que nadie pregunte. Conviene tener clara la diferencia antes de diseñar una integración.

En la práctica casi siempre se usan juntos: el webhook avisa que pasó algo y la API se usa para traer el detalle completo o ejecutar la acción.

Errores comunes al trabajar con APIs

• Ignorar los límites de la plataforma: en Salesforce, por ejemplo, los governor limits restringen cuántas llamadas se pueden hacer; una integración mal pensada los agota y frena el sistema.
• No manejar los errores: una API puede responder que un dato no existe o que el servidor está caído, y la integración tiene que contemplar esos casos en vez de asumir que siempre funciona.
• Hardcodear las claves: dejar una clave de API escrita en el código y subirla a un repositorio es una de las filtraciones de seguridad más frecuentes.
• Tratar la API como mágica: una API no limpia ni transforma datos por sí sola; si los datos de origen están sucios, llegan sucios al destino.

Entender qué es una API es el primer paso para diseñar integraciones que escalen. No es un detalle técnico aislado: es la base sobre la que se construye cualquier ecosistema de software que funcione como un todo.