Una API (Application Programming Interface) es la interfaz que permite a distintas aplicaciones comunicarse con un servidor central para pedir o enviar datos. Si construyes productos digitales, entender qué es una API te ayuda a diseñar software escalable que funcione en web, móvil y escritorio sin duplicar lógica.

La palabra que conviene retener desde el inicio es interfaz. Piensa en la sala de control de una central nuclear o en el tablero de un automóvil: aprietas un botón, mueves una palanca y ocurre algo, sin que tengas que ver los cables ni los mecanismos internos. Una API hace lo mismo, pero con líneas de código en lugar de perillas físicas [01:00].

¿Qué es una API en términos simples?

Una API es un conjunto de instrucciones que un servidor expone para que otras aplicaciones puedan pedirle acciones específicas. Tú no ves la base de datos ni la lógica interna: solo usas la interfaz que el equipo de backend te entrega.

¿Qué significa API? Son las siglas de Application Programming Interface, o interfaz de programación de aplicaciones. Funciona como un panel de control que oculta la complejidad interna y te deja ejecutar acciones con instrucciones simples.

Así como en el tablero de un auto manejas el manubrio, los pedales y la palanca de cambios sin pensar en el motor, en una API tú envías una solicitud a una URL y recibes un resultado. La diferencia es que aquí los botones son endpoints y el motor es la lógica del servidor [01:30].

¿Para qué sirve una API en una aplicación como Twitter?

Imagina un MVP (producto mínimo viable) de Twitter. Tienes una aplicación web, una app nativa para Android y otra para iOS. Si cada una tuviera su propio servidor, mantendrías tres bases de datos distintas y la información se desincronizaría rápido.

La API resuelve eso con un manejo centralizado: un solo servidor con la lógica de negocio y la base de datos, disponible para todos los clientes. En ese MVP de Twitter podrías exponer dos acciones básicas:

• Crear tuits.
• Eliminar tuits.

Desde el frontend, cada cliente se comunica con la API a través de una URL que el equipo de backend proporciona, y envía los datos necesarios para cada operación. Los botones físicos del ejemplo del auto se convierten en URLs y código del lado del servidor [03:10].

¿Por qué construimos APIs?

Porque necesitamos comunicarnos con una variedad de aplicaciones desde un mismo origen de datos. Las APIs son agnósticas al cliente que solicita la información: no les importa si quien pregunta es una app móvil, una web o un script.

Por eso existen APIs de finanzas, de criptomonedas o de clima. Tú pides cierta información, ellas devuelven los datos, y tú decides cómo mostrarlos.

¿Qué quiere decir que una API sea agnóstica? Significa que entrega la misma información sin importar el tipo de cliente que la consume. Una app iOS, una web y un programa de escritorio pueden recibir exactamente la misma respuesta del mismo endpoint.

¿Cómo se usa una API en la práctica con Rick and Morty?

Para verlo en acción, podemos usar la API pública de Rick and Morty desde su playground. La pantalla se divide en dos: a la izquierda escribes la petición, a la derecha aparece el resultado. En el sidebar encuentras la documentación, que es donde se listan los datos que puedes solicitar [04:30].

Dentro de la documentación existe un objeto llamado Query que agrupa todo lo que la API permite pedir: un personaje específico, todos los personajes, episodios, locaciones, entre otros. Para este ejemplo pedimos todos los characters y elegimos algunos campos disponibles, como:

• id.
• name.
• status.
• species.
• type.

¿Cómo escribir una query a una API?

La estructura empieza con la palabra reservada query, seguida del tipo que vas a consultar (characters) y, dentro de llaves, los campos que necesitas. El propio playground va sugiriendo opciones a medida que escribes, lo cual ayuda a explorar la API sin memorizar nada.

Una query mínima se ve así:

graphql query { characters { results { id name status } } }

Al presionar el botón play (el botón rosado central), el playground muestra primero un loading y después el resultado. Ese pequeño detalle es importante: ilustra la asincronía, es decir, la espera mientras el backend procesa y envía la respuesta [06:40].

¿Qué es la asincronía en una API?

Cuando haces una solicitud, la respuesta no llega instantáneamente. El cliente queda esperando hasta que el servidor procese la petición y devuelva los datos. Ese intervalo es lo que llamamos espera asincrónica, y por eso ves indicadores de carga en la mayoría de las apps modernas.

Usar una API bien diseñada te permite que web, móvil y escritorio compartan el mismo recurso, mantengan la información sincronizada y escalen sin duplicar trabajo. ¿Tú ya habías trabajado con alguna API pública? Cuéntame cuál usaste y para qué la integraste.