다음을 통해 공유


최소 API 개요

참고 항목

이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

Warning

이 버전의 ASP.NET Core는 더 이상 지원되지 않습니다. 자세한 내용은 .NET 및 .NET Core 지원 정책을 참조 하세요. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

Important

이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

최소 API는 ASP.NET Core 사용하여 빠른 HTTP API를 빌드하기 위한 간소화된 방법입니다. 최소한의 코드와 구성으로 완벽하게 작동하는 REST 엔드포인트를 빌드할 수 있습니다. 기존 스캐폴딩을 건너뛰고 API 경로 및 작업을 유창하게 선언하여 불필요한 컨트롤러를 방지합니다. 예를 들어 다음 코드는 텍스트 "Hello World!"를 반환하는 웹앱의 루트에 API를 만듭니다.

var app = WebApplication.Create(args);

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

app.Run();

대부분의 API는 경로의 일부로 매개 변수를 허용합니다.

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();

시작하기만 하면 되지만 사용 가능한 것이 전부는 아닙니다. 최소 API는 여러 API로 스케일링하고, 복잡한 경로를 처리하고, 권한 부여 규칙을 적용하고, API 응답의 콘텐츠를 제어하는 데 필요한 구성 및 사용자 지정을 지원합니다. 자습서: ASP.NET Core 사용하여 최소 API 만들기로 시작하는 것이 좋습니다.

몇 가지 코드 예제를 보고 싶으신가요?

코드 예제를 사용하는 일반적인 시나리오의 전체 목록은 최소 API 빠른 참조를 참조하세요.

첫 번째 프로젝트로 바로 이동하시겠어요?

자습서: ASP.NET Core 사용하여 최소 API 만들기 자습서를 사용하여 최소 API 앱을 빌드합니다.