Создание веб-API с помощью ASP.NET Core и MongoDB

Пратик Хандельвал и Скотт Адди

В этом руководстве создается веб-API, который выполняет операции создания, чтения, обновления и удаления (CRUD) в базе данных MongoDB NoSQL.

В этом руководстве вы узнаете, как:

• Настройка MongoDB
• Создание базы данных MongoDB
• Определение коллекции и схемы MongoDB
• Выполнение операций CRUD MongoDB из веб-API
• Настройка сериализации JSON

Предпосылки

• MongoDB 6.0.5 или более поздней версии
• Оболочка MongoDB

Visual Studio

• Visual Studio 2022 с рабочей нагрузкой ASP.NET и разработка веб-приложений.

  

Visual Studio Code

• Visual Studio Code
• Комплект средств разработки C# для Visual Studio Code
• пакет SDK для .NET 9

Вы можете следовать инструкциям Visual Studio Code в macOS, Linux или Windows. Изменения могут потребоваться при использовании интегрированной среды разработки (IDE), отличной от Visual Studio Code.

Настройка MongoDB

Включите доступ к MongoDB и оболочке MongoDB из любого места на машине разработки (Windows/Linux/macOS):

1. Скачайте и установите оболочку MongoDB:

   • macOS/Linux: выберите каталог для извлечения оболочки MongoDB. Добавьте полученный путь к переменной среды mongoshPATH.
   • Windows: Оболочка MongoDB (mongosh.exe) установлена в C:\Users\<user>\AppData\Local\Programs\mongosh. Добавьте полученный путь к переменной среды mongosh.exePATH.

2. Скачайте и установите MongoDB:

   • macOS/Linux: проверьте каталог, по которому был установлен MongoDB, обычно в /usr/local/mongodb. Добавьте полученный путь к переменной среды mongodbPATH.
   • Windows: MongoDB устанавливается в C:\Program Files\MongoDB по умолчанию. Добавьте C:\Program Files\MongoDB\Server\<version_number>\bin в PATH переменную среды.

3. Выберите каталог хранилища данных: выберите каталог на компьютере разработки для хранения данных. Если такого каталога нет, создайте его. Оболочка MongoDB не создает новые каталоги:

   • macOS/Linux: например, /usr/local/var/mongodb.
   • Windows: например, C:\\BooksData.

4. В командной оболочке ОС (а не в оболочке MongoDB) используйте следующую команду, чтобы подключиться к MongoDB через порт 27017 по умолчанию. Замените <data_directory_path> каталог, выбранный на предыдущем шаге.

   mongod --dbpath <data_directory_path>
   

Используйте ранее установленную оболочку MongoDB в следующих шагах для создания базы данных, создания коллекций и хранения документов. Дополнительные сведения о командах оболочки MongoDB см. в статье mongosh.

1. Откройте экземпляр командной оболочки MongoDB, запуская mongosh.exeили выполнив следующую команду в командной оболочке:

   mongosh
   

2. В командной оболочке подключитесь к тестовой базе данных по умолчанию, выполнив следующую команду:

   use BookStore
   

   База данных с именем BookStore создается, если она еще не существует. Если база данных существует, его подключение открывается для транзакций.

3. Создайте коллекцию с помощью следующей Books команды:

   db.createCollection('Books')
   

   Отображается следующий результат:

   { "ok" : 1 }
   

4. Определите схему для Books коллекции и вставьте два документа с помощью следующей команды:

   db.Books.insertMany([{ "Name": "Design Patterns", "Price": 54.93, "Category": "Computers", "Author": "Ralph Johnson" }, { "Name": "Clean Code", "Price": 43.15, "Category": "Computers","Author": "Robert C. Martin" }])
   

   Отображается результат, аналогичный следующему:

   {
       "acknowledged" : true,
       "insertedIds" : [
           ObjectId("61a6058e6c43f32854e51f51"),
           ObjectId("61a6058e6c43f32854e51f52")
        ]
    }
   

   Замечание

   Результаты ObjectId, показанные в предыдущем примере, не будут совпадать с результатами, показанными в командной оболочке.

5. Просмотрите документы в базе данных с помощью следующей команды:

   db.Books.find().pretty()
   

   Отображается результат, аналогичный следующему:

   {
        "_id" : ObjectId("61a6058e6c43f32854e51f51"),
        "Name" : "Design Patterns",
        "Price" : 54.93,
        "Category" : "Computers",
        "Author" : "Ralph Johnson"
    }
    {
        "_id" : ObjectId("61a6058e6c43f32854e51f52"),
        "Name" : "Clean Code",
        "Price" : 43.15,
        "Category" : "Computers",
        "Author" : "Robert C. Martin"
    }
   

   Схема добавляет автоматическое свойство _id типа ObjectId для каждого документа.

Создание проекта веб-API ASP.NET Core

Visual Studio

1. Перейдите к файлу>нового>проекта.
2. Выберите тип проекта веб-API ASP.NET Core и нажмите кнопку "Далее".
3. Назовите проект BookStoreApi и нажмите кнопку "Далее".
4. В диалоговом окне Дополнительные сведения выполните следующие действия.

• Убедитесь, что фреймворк — это .NET 9.0 (Стандартная поддержка версии).
• Убедитесь, что установлен флажок " Использовать контроллеры ".
• Убедитесь, что установлен флажок для включения поддержки OpenAPI.
• Выберите Создать.

1. В окне консоли диспетчера пакетов перейдите в корневой каталог проекта. Выполните следующую команду, чтобы установить драйвер .NET для MongoDB:

   Install-Package MongoDB.Driver
   

Visual Studio Code

1. Выполните следующие команды в командной оболочке:

   dotnet new webapi -o BookStoreApi --use-controllers
   code BookStoreApi
   

   Приведенные выше команды создают новый проект веб-API ASP.NET Core, а затем откройте проект в Visual Studio Code.

2. После запуска сервера OmniSharp появляется диалоговое окно с вопросом "В 'BookStoreApi' отсутствуют необходимые ресурсы для сборки и отладки. Добавить их?". Выберите Да.

3. Откройте интегрированный терминал и выполните следующую команду, чтобы установить драйвер .NET для MongoDB:

   dotnet add package MongoDB.Driver
   

Добавление модели сущности

1. Добавьте каталог Models в корневой каталог проекта.

2. Book Добавьте класс в каталог Models со следующим кодом:

   using MongoDB.Bson;
   using MongoDB.Bson.Serialization.Attributes;
   
   namespace BookStoreApi.Models;
   
   public class Book
   {
       [BsonId]
       [BsonRepresentation(BsonType.ObjectId)]
       public string? Id { get; set; }
   
       [BsonElement("Name")]
       public string BookName { get; set; } = null!;
   
       public decimal Price { get; set; }
   
       public string Category { get; set; } = null!;
   
       public string Author { get; set; } = null!;
   }
   

   В предыдущем классе свойство Id выглядит следующим образом:

   • Требуется для сопоставления объекта CLR с коллекцией MongoDB.
   • Отмечено с помощью [BsonId], чтобы сделать это свойство основным ключом документа.
   • Аннотировано с [BsonRepresentation(BsonType.ObjectId)], чтобы разрешить передачу параметра как типа string, вместо структуры ObjectId. Mongo обрабатывает преобразование из string в ObjectId.

   Свойство BookName аннотировано атрибутом [BsonElement] . Значение атрибута Name представляет имя свойства в коллекции MongoDB.

Добавление модели конфигурации

1. Добавьте следующие значения конфигурации базы данных в appsettings.json:

   {
     "BookStoreDatabase": {
       "ConnectionString": "mongodb://localhost:27017",
       "DatabaseName": "BookStore",
       "BooksCollectionName": "Books"
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*"
   }
   

2. BookStoreDatabaseSettings Добавьте класс в каталог Models со следующим кодом:

   namespace BookStoreApi.Models;
   
   public class BookStoreDatabaseSettings
   {
       public string ConnectionString { get; set; } = null!;
   
       public string DatabaseName { get; set; } = null!;
   
       public string BooksCollectionName { get; set; } = null!;
   }
   

   BookStoreDatabaseSettings Предыдущий класс используется для хранения значений appsettings.json свойств файлаBookStoreDatabase. Имена свойств JSON и C# называются идентичными, чтобы упростить процесс сопоставления.

3. Добавьте указанный выделенный код в Program.cs:

   var builder = WebApplication.CreateBuilder(args);
   
   // Add services to the container.
   builder.Services.Configure<BookStoreDatabaseSettings>(
       builder.Configuration.GetSection("BookStoreDatabase"));
   

   В приведенном выше коде экземпляр конфигурации, к которому привязан раздел файла appsettings.json, регистрируется в контейнере внедрения зависимостей (DI). Например, свойство BookStoreDatabaseSettings объекта ConnectionString заполняется свойством BookStoreDatabase:ConnectionString в appsettings.json.

4. Добавьте следующий код в начало Program.cs, чтобы разрешить ссылку BookStoreDatabaseSettings.

   using BookStoreApi.Models;
   

Добавление службы операций CRUD

1. Добавьте каталог служб в корневой каталог проекта.

2. BooksService Добавьте класс в каталог Служб со следующим кодом:

   using BookStoreApi.Models;
   using Microsoft.Extensions.Options;
   using MongoDB.Driver;
   
   namespace BookStoreApi.Services;
   
   public class BooksService
   {
       private readonly IMongoCollection<Book> _booksCollection;
   
       public BooksService(
           IOptions<BookStoreDatabaseSettings> bookStoreDatabaseSettings)
       {
           var mongoClient = new MongoClient(
               bookStoreDatabaseSettings.Value.ConnectionString);
   
           var mongoDatabase = mongoClient.GetDatabase(
               bookStoreDatabaseSettings.Value.DatabaseName);
   
           _booksCollection = mongoDatabase.GetCollection<Book>(
               bookStoreDatabaseSettings.Value.BooksCollectionName);
       }
   
       public async Task<List<Book>> GetAsync() =>
           await _booksCollection.Find(_ => true).ToListAsync();
   
       public async Task<Book?> GetAsync(string id) =>
           await _booksCollection.Find(x => x.Id == id).FirstOrDefaultAsync();
   
       public async Task CreateAsync(Book newBook) =>
           await _booksCollection.InsertOneAsync(newBook);
   
       public async Task UpdateAsync(string id, Book updatedBook) =>
           await _booksCollection.ReplaceOneAsync(x => x.Id == id, updatedBook);
   
       public async Task RemoveAsync(string id) =>
           await _booksCollection.DeleteOneAsync(x => x.Id == id);
   }
   

   В приведенном коде BookStoreDatabaseSettings экземпляр извлекается из DI с помощью внедрения через конструктор. Этот метод предоставляет доступ к appsettings.json значениям конфигурации, добавленным в разделе "Добавление модели конфигурации ".

3. Добавьте указанный выделенный код в Program.cs:

   var builder = WebApplication.CreateBuilder(args);
   
   // Add services to the container.
   builder.Services.Configure<BookStoreDatabaseSettings>(
       builder.Configuration.GetSection("BookStoreDatabase"));
   
   builder.Services.AddSingleton<BooksService>();
   

   В приведенном выше коде класс BooksService регистрируется в DI для поддержки внедрения через конструктор в потребляющие классы. Время существования одноэлементной службы является наиболее подходящим, так как BooksService находится в прямой зависимости от MongoClient. В соответствии с официальными рекомендациями по повторному использованию клиента Mongo, MongoClient следует зарегистрировать в DI с временем жизни службы singleton.

4. Добавьте следующий код в начало Program.cs, чтобы разрешить ссылку BooksService.

   using BookStoreApi.Services;
   

Класс BooksService использует следующие MongoDB.Driver члены для выполнения операций CRUD с базой данных:

• MongoClient: использует экземпляр сервера для выполнения операций с базой данных. Конструктор этого класса предоставляется в строке подключения MongoDB:

  public BooksService(
      IOptions<BookStoreDatabaseSettings> bookStoreDatabaseSettings)
  {
      var mongoClient = new MongoClient(
          bookStoreDatabaseSettings.Value.ConnectionString);
  
      var mongoDatabase = mongoClient.GetDatabase(
          bookStoreDatabaseSettings.Value.DatabaseName);
  
      _booksCollection = mongoDatabase.GetCollection<Book>(
          bookStoreDatabaseSettings.Value.BooksCollectionName);
  }
  

• IMongoDatabase: представляет базу данных Mongo для выполнения операций. В этом руководстве используется универсальный метод GetCollection<TDocument>(collection) в интерфейсе для получения доступа к данным в определенной коллекции. Выполните операции CRUD с коллекцией после вызова этого метода. В вызове GetCollection<TDocument>(collection) метода:

  • collection представляет имя коллекции.
  • TDocument представляет тип объекта CLR, хранящийся в коллекции.

GetCollection<TDocument>(collection) возвращает объект MongoCollection , представляющий коллекцию. В этом руководстве в коллекции вызываются следующие методы:

• DeleteOneAsync: удаляет один документ, соответствующий указанным условиям поиска.
• Найти<TDocument>: возвращает все документы в коллекции, соответствующие указанным критериям поиска.
• InsertOneAsync: вставляет предоставленный объект в качестве нового документа в коллекцию.
• ReplaceOneAsync: заменяет один документ, соответствующий предоставленным условиям поиска, предоставленным объектом.

Добавление контроллера

BooksController Добавьте класс в каталог Controllers со следующим кодом:

using BookStoreApi.Models;
using BookStoreApi.Services;
using Microsoft.AspNetCore.Mvc;

namespace BookStoreApi.Controllers;

[ApiController]
[Route("api/[controller]")]
public class BooksController : ControllerBase
{
    private readonly BooksService _booksService;

    public BooksController(BooksService booksService) =>
        _booksService = booksService;

    [HttpGet]
    public async Task<List<Book>> Get() =>
        await _booksService.GetAsync();

    [HttpGet("{id:length(24)}")]
    public async Task<ActionResult<Book>> Get(string id)
    {
        var book = await _booksService.GetAsync(id);

        if (book is null)
        {
            return NotFound();
        }

        return book;
    }

    [HttpPost]
    public async Task<IActionResult> Post(Book newBook)
    {
        await _booksService.CreateAsync(newBook);

        return CreatedAtAction(nameof(Get), new { id = newBook.Id }, newBook);
    }

    [HttpPut("{id:length(24)}")]
    public async Task<IActionResult> Update(string id, Book updatedBook)
    {
        var book = await _booksService.GetAsync(id);

        if (book is null)
        {
            return NotFound();
        }

        updatedBook.Id = book.Id;

        await _booksService.UpdateAsync(id, updatedBook);

        return NoContent();
    }

    [HttpDelete("{id:length(24)}")]
    public async Task<IActionResult> Delete(string id)
    {
        var book = await _booksService.GetAsync(id);

        if (book is null)
        {
            return NotFound();
        }

        await _booksService.RemoveAsync(id);

        return NoContent();
    }
}

Предыдущий контроллер веб-API:

• Использует класс BooksService для выполнения операций CRUD.
• Содержит методы действий для поддержки запросов GET, POST, PUT и DELETE HTTP.
• Вызывает CreatedAtAction в методе Create действия для возврата HTTP 201 ответа. Код состояния 201 — это стандартный ответ для метода HTTP POST, который создает новый ресурс на сервере. CreatedAtAction также добавляет заголовок Location в ответ. Заголовок Location задает универсальный код ресурса (URI) только что созданной книги.

Настройка параметров сериализации JSON

В разделе «Тестирование веб-API» необходимо изменить два аспекта, касающихся возвращаемых ответов JSON.

• Имена свойств, оформленные по умолчанию в стиле camelCase, должны быть изменены на оформление в стиле PascalCase в соответствии с именами свойств объекта CLR.
• Свойство bookName должно быть возвращено как Name.

Чтобы удовлетворить указанные выше требования, внесите следующие изменения:

1. В Program.cs добавьте следующий выделенный код к вызову метода AddControllers:

   var builder = WebApplication.CreateBuilder(args);
   
   // Add services to the container.
   builder.Services.Configure<BookStoreDatabaseSettings>(
       builder.Configuration.GetSection("BookStoreDatabase"));
   
   builder.Services.AddSingleton<BooksService>();
   
   builder.Services.AddControllers()
       .AddJsonOptions(
           options => options.JsonSerializerOptions.PropertyNamingPolicy = null);
   

   При предыдущем изменении имена свойств в сериализованном ответе JSON веб-API соответствуют соответствующим именам свойств в типе объекта CLR. Например, Book свойство класса Author сериализуется как Author вместо author.

2. В Models/Book.cs, аннотируйте свойство BookName атрибутом [JsonPropertyName].

   [BsonElement("Name")]
   [JsonPropertyName("Name")]
   public string BookName { get; set; } = null!;
   

   [JsonPropertyName] Значение атрибута Name представляет имя свойства в сериализованном ответе JSON веб-API.

3. Добавьте следующий код в начало Models/Book.cs для разрешения ссылки на атрибут [JsonProperty].

   using System.Text.Json.Serialization;
   

4. Повторите действия, определенные в разделе "Тестирование веб-API ". Обратите внимание на разницу в именах свойств JSON.

Тестирование веб-API

Visual Studio

В этом руководстве для тестирования API используются обозреватель конечных точек и HTTP-файлы .

1. Создайте и запустите приложение.

2. В обозревателе конечных точек щелкните правой кнопкой мыши первую конечную точку /api/books и выберите команду "Создать запрос".

   В файл добавляется следующее содержимое BookStoreApi.http . Если это первый раз, когда создается запрос, файл создается в корневом каталоге проекта.

   @BookStoreApi_HostAddress = https://localhost:<port>
   
   GET {{BookStoreApi_HostAddress}}/api/books
   
   ###
   

   Номер порта уже должен быть задан для порта, используемого приложением, например https://localhost:56874. Если это не так, вы можете найти номер порта в окне вывода при запуске приложения.

3. Выберите ссылку "Отправить запрос " над новой GET строкой запроса.

   Запрос GET отправляется приложению, а ответ отображается в области ответа .

4. Текст ответа показывает результат JSON, содержащий записи книги, аналогичные следующим:

   [
     {
       "Id": "61a6058e6c43f32854e51f51",
       "Name": "Design Patterns",
       "Price": 54.93,
       "Category": "Computers",
       "Author": "Ralph Johnson"
     },
     {
       "Id": "61a6058e6c43f32854e51f52",
       "Name": "Clean Code",
       "Price": 43.15,
       "Category": "Computers",
       "Author": "Robert C. Martin"
     }
   ]
   

5. Чтобы получить одну книгу, щелкните правой кнопкой мыши /api/books/{id}, params (string id) конечную точку GET в обозревателе конечных точек и выберите команду "Создать запрос".

   К файлу добавляется следующее содержимое BookStoreApi.http :

   @id=string
   GET {{BookStoreApi_HostAddress}}/api/books/{{id}}
   
   ###
   

6. Замените id переменную одним из идентификаторов, возвращенных из предыдущего запроса, например:

   @id="61a6058e6c43f32854e51f52"
   GET {{BookStoreApi_HostAddress}}/api/books/{{id}}
   
   ###
   

7. Выберите ссылку "Отправить запрос " над новой GET строкой запроса.

   Запрос GET отправляется приложению, а ответ отображается в области ответа .

8. Тело ответа содержит JSON, аналогичный следующему:

   {
     "Id": "61a6058e6c43f32854e51f52",
     "Name": "Clean Code",
     "Price": 43.15,
     "Category": "Computers",
     "Author": "Robert C. Martin"
   }
   

9. Чтобы проверить конечную точку POST, щелкните правой /api/books кнопкой мыши конечную точку POST и выберите команду "Создать запрос".

   В файл добавляется следующее содержимое BookStoreApi.http :

   POST {{BookStoreApi_HostAddress}}/api/books
   Content-Type: application/json
   
   {
     //Book
   }
   
   ###
   

10. Замените комментарий Book объектом книги в виде текста запроса JSON:

    POST {{BookStoreApi_HostAddress}}/api/books
    Content-Type: application/json
    
     {
       "Name": "The Pragmatic Programmer",
       "Price": 49.99,
       "Category": "Computers",
       "Author": "Andy Hunt"
     }
    
    ###
    

11. Выберите ссылку "Отправить запрос " над строкой POST запроса.

    Запрос POST отправляется в приложение, а ответ отображается в области ответа . Ответ должен содержать только что созданную книгу с назначенным идентификатором.

12. Наконец, чтобы удалить книгу, щелкните правой кнопкой мыши /api/books/{id}, params (string id) конечную точку DELETE и выберите "Создать запрос".

    К файлу добавляется следующее содержимое BookStoreApi.http :

    DELETE {{BookStoreApi_HostAddress}}/api/Books/{{id}}
    
    ###
    

13. Замените id переменную одним из идентификаторов, возвращенных из предыдущего запроса, и нажмите кнопку "Отправить запрос". Рассмотрим пример.

    DELETE {{BookStoreApi_HostAddress}}/api/Books/67f417517ce1b36aeab71236
    
    ###
    

Visual Studio Code

В этом руководстве используется спецификация OpenAPI (openapi.json) и пользовательский интерфейс Swagger для тестирования API.

1. Установите пользовательский интерфейс Swagger, выполнив следующую команду:

dotnet add package NSwag.AspNetCore

Предыдущая команда добавляет пакет NSwag.AspNetCore , содержащий средства для создания документов Swagger и пользовательского интерфейса. Так как наш проект использует OpenAPI, мы используем только пакет NSwag для создания пользовательского интерфейса Swagger.

1. Настроить ПО промежуточного слоя Swagger

В Program.csдобавьте следующий выделенный код:

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.MapOpenApi();
    app.UseSwaggerUI(options =>
    {
        options.SwaggerEndpoint("/openapi/v1.json", "v1");
    });
}

Предыдущий код включает ПО промежуточного слоя Swagger для обслуживания созданного документа JSON с помощью пользовательского интерфейса Swagger. Swagger включен только в среде разработки. Включение Swagger в рабочей среде может предоставлять потенциально конфиденциальные сведения о структуре и реализации API.

Приложение использует документ OpenAPI, созданный OpenApi, расположенный в /openapi/v1.json, для создания пользовательского интерфейса. Просмотрите созданную спецификацию OpenAPI для API WeatherForecast во время выполнения проекта, перейдя к https://localhost:<port>/openapi/v1.json в браузере.

Спецификация OpenAPI — это документ в формате JSON, описывающий структуру и возможности API, включая конечные точки, форматы запросов и ответов, параметры и многое другое. По сути, это схема API, которую можно использовать различными средствами для понимания и взаимодействия с API.

1. Создайте и запустите приложение.

2. В браузере перейдите по адресу https://localhost:<port>/swagger. Swagger предоставляет пользовательский интерфейс для тестирования всех конечных точек API на основе документа OpenAPI.

3. Разверните конечную точку GET /api/books и нажмите кнопку "Попробовать".

4. Нажмите кнопку "Выполнить ", чтобы отправить запрос в API.

5. В разделе "Текст ответа" отображается массив JSON с книгами, похожими на следующие:

   [
     {
       "Id": "61a6058e6c43f32854e51f51",
       "Name": "Design Patterns",
       "Price": 54.93,
       "Category": "Computers",
       "Author": "Ralph Johnson"
     },
     {
       "Id": "61a6058e6c43f32854e51f52",
       "Name": "Clean Code",
       "Price": 43.15,
       "Category": "Computers",
       "Author": "Robert C. Martin"
     }
   ]
   

6. Затем разверните конечную точку GET /api/books/{id} и нажмите кнопку "Попробовать".

7. Введите один из идентификаторов книги из предыдущего ответа в поле идентификатора и нажмите кнопку "Выполнить".

8. В разделе "Текст ответа" отображается объект JSON для указанной книги. Например, результат для идентификатора 61a6058e6c43f32854e51f52 аналогичен следующему:

   {
     "Id": "61a6058e6c43f32854e51f52",
     "Name": "Clean Code",
     "Price": 43.15,
     "Category": "Computers",
     "Author": "Robert C. Martin"
   }
   

9. Чтобы проверить создание новой книги, разверните конечную точку POST /api/books и нажмите кнопку "Попробовать это".

10. Замените текст запроса по умолчанию новым объектом книги:

    {
      "Name": "The Pragmatic Programmer",
      "Price": 49.99,
      "Category": "Computers",
      "Author": "Andy Hunt"
    }
    

11. Нажмите кнопку "Выполнить" , чтобы отправить запрос.

12. Ответ должен иметь код состояния 201 (создано) и включить только что созданную книгу с назначенным идентификатором в тексте ответа.

13. Наконец, чтобы удалить запись книги, разверните конечную точку DELETE /api/book/{id} , нажмите кнопку "Попробовать" и введите один из идентификаторов книги из предыдущего ответа в поле идентификатора . Нажмите кнопку "Выполнить" , чтобы отправить запрос.

14. Ответ должен иметь код состояния 204 (нет содержимого), указывающий, что книга успешно удалена.

Добавление поддержки аутентификации в веб-API

ASP.NET Core Identity позволяет использовать функцию входа в пользовательском интерфейсе для веб-приложений ASP.NET Core. Чтобы защитить веб-API и SPA, используйте один из следующих способов:

• Идентификатор Microsoft Entra
• Azure Active Directory B2C (Azure AD B2C)
• Duende Identity Сервер

Duende Identity Server — это платформа OpenID Connect и OAuth 2.0 для ASP.NET Core. Duende Identity Server включает следующие функции безопасности:

• Проверка подлинности как услуга (AaaS)
• Единый вход и выход (SSO) для нескольких типов приложений
• Контроль доступа для API
• Шлюз федерации

Это важно

Компания Duende Software может потребовать оплаты лицензионного сбора за использование Duende Identity Server в производственной среде. Дополнительные сведения см. в статье "Миграция из ASP.NET Core в .NET 5 в .NET 6".

Дополнительные сведения см. в документации по Duende Identity Server (на веб-сайте ПО Duende).

Дополнительные ресурсы

• Просмотр или скачивание примера кода (как скачать)
• Создание веб-API с помощью ASP.NET Core
• Типы возвращаемых действий контроллера в веб-API ASP.NET Core
• Создание веб-API с помощью ASP.NET Core