0
0

Add API documentation

This commit is contained in:
Serghei Cebotari 2024-01-14 23:03:52 +03:00
parent 0452f379c6
commit 27dd2af627
4 changed files with 113 additions and 69 deletions

View File

@ -17,6 +17,10 @@ namespace RhSolutions.Api.Controllers
this.parser = parser;
}
/// <summary>
/// Возвращает все продукты в базе данных
/// </summary>
/// <returns></returns>
[HttpGet]
public IAsyncEnumerable<Product> GetProducts()
{
@ -24,6 +28,11 @@ namespace RhSolutions.Api.Controllers
.AsAsyncEnumerable();
}
/// <summary>
/// Возвращает продукт по номеру артикула
/// </summary>
/// <param name="id">Номер артикула</param>
/// <returns></returns>
[HttpGet("{id}")]
public IEnumerable<Product> GetProduct(string id)
{
@ -31,6 +40,10 @@ namespace RhSolutions.Api.Controllers
.Where(p => p.Id.Equals(id));
}
/// <summary>
/// Загрузка прайс-листа в формате xlsx в базу данных
/// </summary>
/// <returns></returns>
[HttpPost]
public IActionResult PostProductsFromXls()
{
@ -62,6 +75,10 @@ namespace RhSolutions.Api.Controllers
}
}
/// <summary>
/// Удаление всех продуктов из базы данных
/// </summary>
/// <returns></returns>
[HttpDelete]
public IActionResult DeleteAllProducts()
{

View File

@ -14,6 +14,11 @@ namespace RhSolutions.Api.Controllers
this.context = context;
}
/// <summary>
/// Поиск артикула в базе данных через предварительную мультиклассовую классификацию с применением ML-модели артикулов
/// </summary>
/// <param name="query">Запрос в свободной форме</param>
/// <returns></returns>
[HttpGet]
public IAsyncEnumerable<Product> SearchProducts([FromQuery] string query)
{

View File

@ -5,6 +5,8 @@ using RhSolutions.Api.Middleware;
using RhSolutions.QueryModifiers;
using RhSolutions.QueryModifiers.DrinkingWaterHeatingFittings;
using RhSolutions.QueryModifiers.DrinkingWaterHeatingPipes;
using Microsoft.OpenApi.Models;
using System.Reflection;
var builder = WebApplication.CreateBuilder(args);
@ -60,7 +62,25 @@ builder.Services.AddKeyedTransient<IProductQueryModifier, Sleeve>("Монтаж
.AddKeyedTransient<IProductQueryModifier, StabilPipe>("Stabil")
.AddKeyedTransient<IProductQueryModifier, BlackPipe>("Black");
builder.Services.AddSwaggerGen();
builder.Services.AddSwaggerGen(options =>
{
options.SwaggerDoc("v1", new OpenApiInfo
{
Version = "v1",
Title = "RhSolutions API",
Description = "API к базе данных артикулов РЕХАУ для поиска с помощью ML.NET и полнотестового поиска PostgreSQL",
Contact = new OpenApiContact
{
Name = "Serghei Cebotari",
Url = new Uri("https://cebotari.ru/"),
Email = @"serghei@cebotari.ru"
}
});
var xmlFilename = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, xmlFilename));
});
var app = builder.Build();

View File

@ -5,6 +5,8 @@
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<UserSecretsId>1c307973-55cf-4d5c-a4f8-1def6b58ee3c</UserSecretsId>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
<NoWarn>$(NoWarn);1591</NoWarn>
</PropertyGroup>
<ItemGroup>