Como criar uma Minimal API em .NET para consulta de CPF

dotnet new web -n CpfMinimalApi
cd CpfMinimalApi

public record CpfResponse(bool Success, CpfData Data);

public record CpfData(
    string Cpf,
    string Name,
    string NameUpper,
    string Gender,
    string BirthDate,
    string Day,
    string Month,
    string Year
);

public record CpfResult(
    bool Valid,
    string Cpf,
    string? Name,
    string? BirthDate,
    string? Gender,
    string Message
);

public record ErrorResponse(string Message, int StatusCode);

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddHttpClient("CpfHub", client =>
{
    client.BaseAddress = new Uri("https://api.cpfhub.io/");
    client.DefaultRequestHeaders.Add("x-api-key",
    builder.Configuration["CpfHub:ApiKey"]);
    client.Timeout = TimeSpan.FromSeconds(10);
});

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.MapGet("/api/cpf/{cpf}", async (
    string cpf,
    IHttpClientFactory httpClientFactory) =>
{
    var cpfLimpo = new string(cpf.Where(char.IsDigit).ToArray());

    if (cpfLimpo.Length != 11)
    return Results.BadRequest(new ErrorResponse(
    "CPF deve conter exatamente 11 dígitos", 400));

    var client = httpClientFactory.CreateClient("CpfHub");

    try
    {
    var response = await client.GetAsync($"cpf/{cpfLimpo}");

    if (!response.IsSuccessStatusCode)
    return Results.NotFound(new ErrorResponse(
    "CPF não encontrado", 404));

    var dados = await response.Content
    .ReadFromJsonAsync<CpfResponse>();

    if (dados is not { Success: true })
    return Results.NotFound(new ErrorResponse(
    "CPF não encontrado na base", 404));

    return Results.Ok(new CpfResult(
    true, dados.Data.Cpf, dados.Data.Name,
    dados.Data.BirthDate, dados.Data.Gender,
    "CPF encontrado com sucesso"
    ));
    }
    catch (TaskCanceledException)
    {
    return Results.StatusCode(504);
    }
    catch (HttpRequestException)
    {
    return Results.StatusCode(502);
    }
})
.WithName("ConsultarCpf")
.WithOpenApi()
.Produces<CpfResult>(200)
.Produces<ErrorResponse>(400)
.Produces<ErrorResponse>(404);

app.Run();

app.MapGet("/api/cpf/validar/{cpf}", (string cpf) =>
{
    var cpfLimpo = new string(cpf.Where(char.IsDigit).ToArray());

    if (cpfLimpo.Length != 11)
    return Results.BadRequest(new { valid = false, message = "CPF incompleto" });

    if (cpfLimpo.Distinct().Count() == 1)
    return Results.BadRequest(new { valid = false, message = "CPF com dígitos repetidos" });

    var soma = 0;
    for (int i = 0; i < 9; i++)
    soma += (cpfLimpo[i] - '0') * (10 - i);
    var d1 = soma % 11 < 2 ? 0 : 11 - (soma % 11);

    soma = 0;
    for (int i = 0; i < 10; i++)
    soma += (cpfLimpo[i] - '0') * (11 - i);
    var d2 = soma % 11 < 2 ? 0 : 11 - (soma % 11);

    var valido = cpfLimpo[9] - '0' == d1 && cpfLimpo[10] - '0' == d2;

    return valido
    ? Results.Ok(new { valid = true, message = "CPF válido" })
    : Results.BadRequest(new { valid = false, message = "Dígitos verificadores inválidos" });
})
.WithName("ValidarCpf")
.WithOpenApi();

// Arquivo: requests.http

### Consultar CPF
GET https://localhost:5001/api/cpf/12345678900

### Validar formato do CPF
GET https://localhost:5001/api/cpf/validar/12345678900

### CPF inválido
GET https://localhost:5001/api/cpf/validar/11111111111