Compartir a través de

Introducción a las API mínimas

  • Artículo

Nota:

Esta no es la versión más reciente de este artículo. Para la versión actual, consulte la versión .NET 8 de este artículo.

Advertencia

Esta versión de ASP.NET Core ya no se admite. Para obtener más información, consulte la Directiva de soporte técnico de .NET y .NET Core. Para la versión actual, consulte la versión .NET 8 de este artículo.

Importante

Esta información hace referencia a un producto en versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.

Para la versión actual, consulte la versión .NET 8 de este artículo.

Las API mínimas son un enfoque simplificado para crear API de HTTP rápidas con ASP.NET Core. Puede crear puntos de conexión totalmente funcionales REST con código y configuración mínimos. Omita el andamiaje tradicional y evite controladores innecesarios mediante la declaración fluida de las rutas y acciones de la API. Por ejemplo, el código siguiente crea una API en la raíz de la aplicación web que devuelve el texto, "Hello World!".

var app = WebApplication.Create(args);

app.MapGet("/", () => "Hello World!");

app.Run();

La mayoría de las API aceptan parámetros como parte de la ruta.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.MapGet("/users/{userId}/books/{bookId}", 
    (int userId, int bookId) => $"The user id is {userId} and book id is {bookId}");

app.Run();

Eso es todo lo que se necesita para empezar, pero no es todo lo que está disponible. Las API mínimas admiten la configuración y la personalización necesarias para escalar a varias API, controlar rutas complejas, aplicar reglas de autorización y controlar el contenido de las respuestas de las API. Un buen lugar para empezar es Tutorial: Creación de una API mínima con ASP.NET Core.

¿Desea ver algunos ejemplos de código?

Para obtener una lista completa de escenarios comunes con ejemplos de código, consulte Referencia rápida de las API mínimas.

¿Quiere ir directamente al primer proyecto?

Cree una aplicación de API mínima con nuestro tutorial: Tutorial: Creación de una API mínima con ASP.NET Core.