Entender qué es una API resulta fundamental para cualquier persona involucrada en la creación de productos digitales. Detrás de cada aplicación móvil, sitio web o plataforma que usas a diario, existe una pieza clave que permite la comunicación entre sistemas: la interfaz de programación de aplicaciones. A continuación, se explica de forma clara y práctica cómo funcionan, por qué existen y cómo puedes experimentar con una en tiempo real.
¿Qué significa API y por qué la palabra interfaz es clave?
API corresponde a las siglas de Application Programming Interface, o interfaz de programación de aplicaciones [0:12]. La palabra más importante dentro de esta definición es interfaz. Para comprenderlo, piensa en el panel de control de una central nuclear: botones, perillas e indicadores que permiten operar todo el sistema sin necesidad de conocer los cables o mecanismos internos [0:30]. Tú presionas un botón para enfriar el núcleo y la central lo ejecuta por ti.
Lo mismo ocurre con el tablero de un automóvil [1:05]. El manubrio, los pedales y la palanca de cambios son tu interfaz para hacer funcionar el vehículo. En el mundo del software, una API cumple exactamente el mismo rol: no hay botones físicos, pero sí líneas de código que responden cuando alguien realiza una solicitud [1:22].
¿Cómo funciona una API en un producto real como Twitter?
Imagina un MVP (Minimum Viable Product) de Twitter [1:35]. Existen distintas formas de acceder a la plataforma: aplicación web, aplicación nativa para Android y aplicación nativa para iOS. La API permite un manejo centralizado de todas las peticiones que llegan desde cualquiera de esas aplicaciones.
- No se necesita un servidor diferente para cada plataforma.
- Un solo servidor contiene la lógica de negocios y la base de datos centralizada.
- Toda esa funcionalidad queda disponible a través de la API [1:55].
En este MVP simplificado, la API ofrece únicamente dos acciones: crear tweets y eliminar tweets. Desde el front-end (el cliente), la comunicación se establece enviando datos a una URL proporcionada por el equipo de back-end [2:18]. Los botones físicos de los ejemplos anteriores se transforman aquí en URLs y código del lado del servidor que maneja cada solicitud.
¿Por qué las APIs son agnósticas al cliente?
Las APIs existen porque necesitamos comunicarnos con una variedad de aplicaciones: móvil, escritorio y web [2:45]. Son agnósticas respecto a quién solicita la información, lo que significa que entregan datos sin importar la plataforma de origen. Existen APIs de finanzas, criptomonedas y clima que funcionan bajo este mismo principio: tú solicitas información y la API te entrega los datos para usarlos donde los necesites [2:58].
¿Cómo probar una API real con el ejemplo de Rick and Morty?
Para ver una API en acción, se utiliza el playground de la API de Rick and Morty [3:20]. La pantalla se divide en dos secciones: a la izquierda se escribe la petición y a la derecha aparece el resultado. En el sidebar se encuentra la documentación, que describe todos los datos disponibles para consultar.
¿Qué datos puedes solicitar a esta API?
Dentro de la documentación aparece un objeto llamado query que contiene todos los elementos disponibles [3:45]: personajes individuales, listados de personajes, episodios, entre otros. Al explorar el tipo Characters, se encuentran campos como:
- Nombre del personaje.
- Estado (vivo, muerto, desconocido).
- Especie y tipo.
- ID único.
Para escribir la primera consulta, se utiliza la palabra reservada query, seguida del tipo characters [4:15]. El playground ofrece sugerencias automáticas a medida que escribes, facilitando la exploración de datos disponibles.
graphql
query {
characters {
results {
id
name
status
}
}
}
Al presionar el botón de ejecución, aparece un loading que representa una espera sincrónica [5:00]. Una vez que el back-end procesa la solicitud, devuelve todos los personajes de la serie con los campos solicitados: ID, nombre y estado.
Este ejercicio práctico permite comprender conceptos como la asincronía y la sincronía en la espera de respuestas del servidor [5:20]. La API de Rick and Morty es un recurso excelente para experimentar sin riesgos y familiarizarte con el flujo de petición y respuesta.
La creación de software escalable depende en gran medida de las APIs. Si tu compañía desarrolla aplicaciones web y móviles, un solo recurso centralizado sirve a todas las plataformas. ¿Ya habías trabajado con alguna API? Comparte tu experiencia en los comentarios.
