Cómo conectarse a una API

Summary

El video explica de manera clara y práctica qué es una API, desmitificando la idea de que solo se conecta a la web, y cómo funciona como intermediario y capa de seguridad entre sistemas. Se profundiza en REST como estándar para APIs web, usando verbos HTTP sobre recursos y retornando datos, usualmente en JSON. Además, muestra cómo crear y ejecutar una API mínima en .NET 10, consumirla con JavaScript y solucionar problemas de seguridad con CORS. La explicación combina teoría, analogías y ejemplos prácticos, ofreciendo una guía completa desde la conceptualización hasta la implementación y consumo de APIs de manera segura y funcional.

Takeaways

• 😀 Una API (Application Programming Interface) permite la comunicación entre sistemas, no necesariamente a través de la web.
• 😀 Las APIs no solo sirven para web, también existen APIs para interactuar con sistemas operativos y dispositivos, como cámaras o sensores de un celular.
• 😀 Las APIs actúan como intermediarios y pueden funcionar como capas de seguridad, autorización y validación de permisos.
• 😀 Un error en la API puede provocar resultados inesperados en las aplicaciones que dependen de ella, resaltando la importancia de su correcta implementación.
• 😀 REST es un patrón arquitectónico ampliamente utilizado en APIs web que maneja recursos a través de URLs y utiliza verbos HTTP como GET, POST, PUT y DELETE.
• 😀 En REST, el recurso siempre tiene la misma URL y la acción sobre él se define por el verbo HTTP; el formato JSON es el más común, pero no obligatorio.
• 😀 Al crear una API en .NET 10, se puede utilizar un enfoque de Minimal APIs para proyectos simples o microservicios, y se genera un endpoint de ejemplo como 'WeatherForecast'.
• 😀 Para consumir la API desde JavaScript, se puede usar `fetch` para obtener datos y manejar errores, mostrando la respuesta en la interfaz de manera organizada.
• 😀 CORS (Cross-Origin Resource Sharing) es una capa de seguridad que restringe qué aplicaciones pueden consumir la API; debe configurarse correctamente para entornos de desarrollo y producción.
• 😀 Habilitar CORS permite que aplicaciones externas consuman la API, y se puede ajustar dinámicamente en la configuración (`appsettings.json`) para restringir accesos solo a URLs autorizadas.
• 😀 Visual Studio 2026 facilita la creación, ejecución y prueba de APIs con herramientas integradas que permiten ejecutar endpoints y verificar respuestas sin necesidad de software adicional.

Q & A

¿Qué significa API y cuál es su función principal?

API significa Application Programming Interface. Su función principal es actuar como intermediario entre dos sistemas, permitiendo la comunicación y el intercambio de datos de manera segura y estructurada.

¿Todas las APIs son web APIs?

No. No todas las APIs son web APIs. También existen APIs para interactuar con sistemas operativos, dispositivos móviles, cámaras u otros sensores, no necesariamente a través de la web.

¿Por qué se considera a las APIs un elemento de seguridad?

Las APIs pueden actuar como capa de seguridad, controlando quién puede acceder a los datos, validando permisos, autenticaciones y autorizaciones antes de permitir la interacción con el sistema o los recursos.

¿Qué analogía se utiliza para explicar el papel de una API?

Se compara una API con un traductor entre dos personas que hablan idiomas diferentes. La API traduce la información para que ambos sistemas puedan comunicarse correctamente y evitar errores de interpretación.

¿Qué es REST y por qué es importante en las APIs web?

REST (Representational State Transfer) es un patrón arquitectónico estándar para APIs web. Su importancia radica en que permite manejar recursos a través de URLs y verbos HTTP como GET, POST, PUT y DELETE, siguiendo estándares consistentes para comunicación en red.

¿Qué formatos de respuesta puede devolver una API?

Una API puede devolver cualquier tipo de recurso, como JSON, XML, texto o archivos. JSON es el más común debido a su compatibilidad con JavaScript, pero no es obligatorio.

¿Qué es CORS y por qué es relevante al consumir APIs?

CORS (Cross-Origin Resource Sharing) es una política de seguridad que determina qué aplicaciones pueden consumir una API desde diferentes orígenes. Evita accesos no autorizados desde dominios externos.

¿Qué pasos se siguieron para crear una API en .NET 10?

Se utilizó el comando `dotnet new webapi` para crear el proyecto, luego `dotnet restore` para instalar dependencias y `dotnet build` para compilarlo. Se revisó la estructura del proyecto y se ejecutó con `dotnet run`.

¿Qué son las minimal APIs en .NET y cuándo se utilizan?

Las minimal APIs son un estilo simplificado de crear APIs en .NET, utilizado cuando la API es pequeña o para microservicios y funciones específicas. Permite mapear rutas directamente sin controladores complejos.

¿Cómo se solucionó el problema de acceso a la API desde el navegador?

Se habilitó CORS en el proyecto .NET mediante `builder.Services.AddCors()` y la configuración del middleware con `app.UseCors()`, permitiendo que la aplicación cliente pudiera consumir la API sin bloqueos.

¿Qué utilidad tiene el archivo HTTP en Visual Studio 2022?

El archivo HTTP permite probar la API directamente desde Visual Studio, simulando peticiones HTTP como si se usara Postman, y facilita mantener pruebas dentro del repositorio del proyecto.

¿Qué sucede cuando se llama al endpoint `weerforecast` de la API creada?

El endpoint devuelve cinco elementos aleatorios con fecha, temperatura y un resumen del clima. Cada petición genera datos diferentes gracias a la lógica implementada en el controlador por defecto.