Qué es una API: para qué sirve, cómo funciona y ejemplos cotidianos

Una API (interfaz de programación de aplicaciones, por sus siglas en inglés) es un conjunto de reglas que permite que un programa le pida datos o acciones a otro sin conocer cómo funciona por dentro. Define qué se puede pedir, en qué formato y qué se recibe de vuelta. Es la forma estándar en que se conectan las aplicaciones, los sitios web y los servicios en la nube.

Para qué sirve una API

Una API sirve para que un sistema use lo que otro ya hace, en vez de construirlo desde cero. Una tienda en línea no programa su propio sistema de pagos: llama a la API de un procesador de pagos. Una aplicación de delivery no dibuja sus propios mapas: usa la API de un servicio de mapas.

Sus usos principales:

• Integrar sistemas. Conectar la tienda con el inventario, el ERP con el banco, el CRM con el correo.
• Automatizar tareas. Un programa puede hacer por API lo que una persona haría con clics: crear un pedido, emitir un documento, descargar un reporte.
• Separar el frontend del backend. La aplicación del teléfono y el sitio web leen los mismos datos desde la misma API.
• Abrir un servicio a terceros. Una empresa publica su API para que otros construyan productos encima.

La API también protege: expone solo lo que el dueño decide y exige credenciales para usarla. Quien la consume nunca toca la base de datos directamente.

Cómo funciona: la analogía del mesero

La comparación más usada es la de un restaurante. Tú (el programa cliente) no entras a la cocina (el sistema). Le pides al mesero (la API) un plato de la carta (las operaciones disponibles). El mesero lleva el pedido, la cocina lo prepara y el mesero te trae el resultado. Si pides algo que no está en la carta, te dice que no se puede.

En términos técnicos, el intercambio tiene dos partes:

1. La solicitud (request). El cliente envía una dirección (endpoint), una acción y, si corresponde, datos y una credencial.
2. La respuesta (response). El servidor devuelve un código de estado (por ejemplo, 200 si salió bien o 404 si no encontró el recurso) y los datos, casi siempre en formato JSON.

Qué es una API REST

REST es el estilo más común para construir APIs web. Usa el protocolo HTTP, el mismo de las páginas web, y organiza todo en recursos con su propia dirección: /clientes, /clientes/25, /pedidos. Sobre cada recurso se aplican verbos HTTP:

Una respuesta típica en JSON se ve así:

{
  "id": 25,
  "nombre": "Comercial Los Andes",
  "correo": "contacto@ejemplo.com"
}

Existen otros estilos. SOAP es más antiguo, usa XML y sigue presente en bancos y organismos públicos. GraphQL permite que el cliente pida exactamente los campos que necesita en una sola consulta. gRPC se usa entre servicios internos cuando importa la velocidad. Para la mayoría de las integraciones, REST con JSON es la opción por defecto.

Ejemplos de APIs que usas a diario

• Iniciar sesión con Google o Apple en otra aplicación: esa aplicación usa la API de autenticación de Google o Apple.
• El clima en tu teléfono: la aplicación consulta la API de un servicio meteorológico.
• Pagar en una tienda en línea: el sitio envía el cobro a la API del procesador de pagos y recibe si fue aprobado.
• Un mapa dentro de una página de reservas: se carga desde la API de un servicio de mapas.
• Un asistente de inteligencia artificial dentro de otra aplicación: la aplicación envía tu texto a la API de un modelo de lenguaje y muestra la respuesta.
• Automatizaciones entre aplicaciones: herramientas como n8n conectan decenas de servicios usando sus APIs.

Un ejemplo chileno: la facturación electrónica

En Chile, cada factura, boleta o nota de crédito electrónica debe enviarse al Servicio de Impuestos Internos (SII). Una empresa pequeña puede emitirlas a mano en el portal del SII, pero cuando las ventas ocurren en una tienda en línea o en un sistema de gestión, lo normal es integrarlas por API.

El flujo habitual es este: el sistema de ventas envía los datos de la venta a la API de un proveedor de facturación electrónica; el proveedor genera el documento, lo firma, lo envía al SII y devuelve el folio y el PDF. Todo ocurre en segundos y sin que nadie copie datos a mano. Si te interesa armar esto con herramientas libres, revisa facturación electrónica en Chile con software libre.

Tipos de API según quién puede usarlas

Que una API sea pública no significa que sea gratis: muchas cobran por número de consultas o limitan cuántas se pueden hacer por minuto.

Cómo empezar a usar una API

1. Lee la documentación. Toda API seria publica sus endpoints, parámetros y ejemplos. Muchas usan el estándar OpenAPI, que permite probarlas desde el navegador.
2. Obtén una credencial. Suele ser una clave (API key) o un token. Trátala como una contraseña: nunca la publiques en un repositorio.
3. Haz una primera llamada con una herramienta como curl desde la terminal:

curl https://api.ejemplo.com/clientes/25 -H "Authorization: Bearer TU_TOKEN"

4. Revisa el código de estado y el JSON que vuelve.
5. Pasa a código en el lenguaje que uses. En Python, por ejemplo, la biblioteca requests lo resuelve en pocas líneas.

Las limitaciones a tener en cuenta: una API puede cambiar de versión y romper tu integración, puede caerse, y el proveedor puede subir el precio o cerrarla. Por eso conviene depender de APIs bien documentadas, con versiones estables, y manejar los errores en tu código.

Preguntas frecuentes

¿Qué significa API? API significa Application Programming Interface, en español interfaz de programación de aplicaciones. Es el conjunto de reglas con que un programa se comunica con otro.

¿Qué diferencia hay entre una API y una API REST? API es el concepto general de una interfaz entre programas. Una API REST es un tipo específico que usa HTTP, organiza los datos en recursos con su propia dirección y suele responder en JSON.

¿Necesito saber programar para usar una API? Para integrarla en un sistema, sí, al menos lo básico. Herramientas de automatización como n8n permiten usar muchas APIs sin escribir código.

¿Las APIs son gratis? Depende del proveedor. Hay APIs gratuitas, otras con un nivel gratuito limitado y otras que cobran por consulta o por suscripción.

¿Una API es segura? Lo es si está bien diseñada: exige credenciales, cifra la comunicación con HTTPS y expone solo los datos necesarios. Una clave filtrada permite que otro la use en tu nombre, así que hay que guardarla bien.

Fuentes

• Especificación OpenAPI, OpenAPI Initiative.
• Métodos de petición HTTP, MDN Web Docs.
• Códigos de estado de respuesta HTTP, MDN Web Docs.
• Factura electrónica, Servicio de Impuestos Internos.