¿Qué es una API y para qué sirve en una aplicación?

Publicado el 2026-10-17 por frfrand

Qué es una API, cómo se comunican frontend y backend, ejemplos cotidianos y diferencias entre una API y una página web.

Abrís una aplicación para consultar el clima y ves que mañana va a llover. Tu teléfono no tiene una estación meteorológica en cada ciudad. En algún momento pidió esa información a otro servicio. Una API define cómo puede un programa pedirle datos o funciones a otro.

API significa Application Programming Interface, o interfaz de programación de aplicaciones. Suena muchísimo más complicado de lo que es.

La explicación del restaurante

Pensá en la carta de un restaurante. No necesitás saber cómo se organiza la cocina para pedir un plato. La carta te muestra qué podés solicitar, y el personal se encarga de llevar el pedido y traer el resultado.

Una API funciona de manera parecida: ofrece operaciones conocidas. Una aplicación pide información o solicita una acción y recibe una respuesta según las reglas definidas.

La comparación tiene un límite: una API no es siempre un servidor en Internet. Tu navegador, tu sistema operativo y muchas bibliotecas de programación también ofrecen APIs internas. Pero las APIs web son especialmente fáciles de reconocer porque conectan programas a través de la red.

Un ejemplo real: la tienda online

Imaginá una tienda con catálogo, carrito y pedidos. El navegador muestra botones e imágenes, pero alguien necesita guardar información.

Cuando una persona pulsa «ver productos», el frontend puede llamar a una API del backend. El backend consulta la base de datos y devuelve los resultados. Cuando alguien confirma una compra, el frontend solicita otra operación y el backend comprueba disponibilidad, permisos y condiciones de pago.

El frontend no debería conectarse libremente a toda la base de datos con una contraseña de administrador. Una API bien diseñada ayuda a controlar qué operaciones están permitidas.

¿Qué se envía en una solicitud?

En una API web basada en HTTP es habitual encontrar:

• Una dirección: por ejemplo, /api/productos.
• Un método: GET para consultar, POST para crear o enviar datos, entre otros.
• Datos adicionales: filtros, identificadores o un contenido en JSON.
• Una respuesta: información o un estado que indica qué ocurrió.

Por ejemplo, una respuesta podría ser:

{
  "producto": "Teclado",
  "precio": 35,
  "disponible": true
}

Eso es JSON: una forma de representar datos que dos programas pueden intercambiar. No es una página visual bonita, porque el objetivo es que otra aplicación pueda interpretarlo.

¿API, REST y webhook son lo mismo?

No. API es el concepto general. REST describe un estilo de diseño frecuente en APIs web. Webhook es un mecanismo con el que un sistema avisa a otro cuando ocurre un evento.

Una API puede dejar que consultes los pedidos cuando quieras. Un webhook podría avisarte justo cuando aparece uno nuevo. Ambos pueden convivir.

¿Todas las APIs son públicas?

Para nada. Algunas son internas de una empresa, otras están destinadas a socios y otras permiten accesos públicos limitados. Una API puede requerir identificación, permisos, límites de solicitudes y comprobaciones de seguridad.

Que un endpoint exista no significa que cualquiera tenga permiso para ejecutarlo. Ese detalle es fundamental cuando la API gestiona clientes, pagos o infraestructura.

¿Dónde aparece esto en ArduMaker?

ArduMaker utiliza interfaces para comunicar componentes de su plataforma y ofrece herramientas que permiten operar ciertos servicios desde integraciones. Entender una API ayuda a comprender también por qué un agente de IA necesita permisos y acciones definidas para interactuar con un sistema real.

En una frase: una API es un acuerdo sobre cómo dos partes de software pueden comunicarse. No necesitás memorizar todos los métodos HTTP para entender su utilidad, pero sí saber qué datos se intercambian y quién está autorizado.

Para ampliar: Introducción a las APIs de MDN.